chakra readme v1.0

5/10/2018 Chakra Readme v1.0 - slidepdf.com

http://slidepdf.com/reader/full/chakra-readme-v10 1/19

Chakra Readme v 1.0_1

Contents

I. Installing Chakra

II. Getting Started

II.1. Basic Features

II.2. Desktop Editor

III. Advanced Features

III.1. Custom Icons

III.2. PlugIns

III.3. External Widgets

IV. PlugIn Documentation

IV.1. Wallpaper Changer




I. Installing Chakra

First off, make sure you have a programm which allows you to open and extract ZIP archives.

New operating system come with an integrated ZIP support, but programms like 7zip extend

the support to several other archive types such as RAR, 7z and TAR.

There are two editions of Chakra available: Full and Lite.

The only difference between these two editions is that the Full edition contains all PlugIns I

created. They are already pre-installed. At the moment, these PlugIns are

- Album Art Wallpaper

- Travel Mode

- Wallpaper Changer

- Startup Actions

- Event Manager

The Lite edition contains the Event Manager PlugIn only.

After you have chosen the edition you want to install, open the archive and extract its

contents to

X:\System\Flash UI\ (where X: is the drive letter of you Cowon player)

After that, open the 'Flash UI' folder and rename the file 'mainmenuN.swf' to

mainmenu1/2/3.swf, depending on which mainmenu you want to replace. If you didn't knowthere are three different mainmenus you can use, read your players manual about this topic.

If you did so and the default mainmenu still is shown, make sure you are in the correct

mainmenu. Another reason may be that your operating system doesn't show file extension

and you added the .swf extension to the mainmenu file regardless. If this is the case, the

mainmenu file must be named 'mainmenu1/2/3' of course.




II. Getting Started

II.1. Basic Features

If you use Chakra the first time, you'll see this screen.

The bar at the top, the infobar, shows general information such as the current time, the

battery state and the volume.

The bar at the bottom is the menubar. It contains buttons to access all functions of Chakra.




1. Menu

2. Icons / Widgets

3. Launcher Button

4. Shutdown

5. Switch Menu

6. Settings

7. Music/Radio Bar (+ integrated music player)




1. Menu

This is the main menu where you can access Chakra's settings, set the sleep timer, toogle

bluetooth and change the volume and brightness. The version of Chakra installed on your

Cowon player is shown, as well as the date that Chakra version was published.




2. Icons / Widgets

In this menu all available icons and widgets are shown. In case there are two or more pages,

there is an indicator on the rigth side which shows the current page.

Icons and widgets which are already in use are semi-transparent.

In order to add an icon to your desktop, press and hold it until the menu closes itself and you

can drag the icon around. More about this feature, the Desktop Editor, later.




3. Launcher Button

The Launcher Button is a button you can assign a certain action to. By default, this button

opens the Lock Screen. In the settings you can change the action to something else.

4. Shutdown

Opens a popup where you can shut the player down, set it to sleep mode or open the lock

screen.

5. Switch Menu

Opens a popup where you can go to another menu. If you didn't know there are multiple

mainmenus you can use, read your player's manual.




6. Settings

This is a quick reference for all available settings. PlugIn settings aren't documented.

About the various button types: (This list is about the right side of the buttons)

- Numeric value: Slide the button to change the setting's value

- String value: Tap the button to open a list of available options

- Arrow: Opens a sub category

- Glowing/gray circle: Tap to enable (glowing) or disable (gray) the setting

- Nothing: Miscellaneous type; may open the keyboard and you have to enter something




General

Resume Last Screen [Switch Button]

If enabled, the last screen (music, videos, pictures,...) isshown on startup

Desktops [Slider Button]

Set the number of available desktops.

If there are icons or widgets on a desktop you deleted,

they are removed automatically.

Icon Labels [Switch Button]

Default Mode [Option Button]Last used: Start the last mode (radio, music) you used on

startup

Music: Always start the music mode on startup

Radio: Always start the radio mode on startup

Volume Limit [Slider Button]

The volume limit feature prevents that you exceed the

limit you set here.

Use Volume Limit [Switch Button]

Extended Text Scroller [Switch Button]

If enabled, labels with a text being too long pauses for a

second when it exceeds the bounds.

Track Notification [Switch Button]

The current track being played is shown every time you

enter Chakra. (Works only in music mode of course)

Menubar: Icon Size [Option Button]Large

Small

Music Player: Single Tap

"Gesture"

[Switch Button]

If enabled, the music is played/paused if you tap the

integrated music player's album art area.

Menubar: Move Desktop on

hide

[Switch Button]

If enabled, the desktop's content is moved down if youhide the menubar.




Security

Unlock Method [Option Button]

Android PatternHold

Rotate

Shake

Slide

Configure Android Pattern [Misc Button]

The Android Pattern works similar to Android's unlock

pattern. Press and hold a dot and draw a pattern.

If no pattern is set, you can unlock the player by entering

any pattern.

Show on Startup [Switch Button]

Password [Input Button]

Set the password you have to enter if the password

protection is enabled.

Password Protection Enabled [Switch Button]

If enabled, you have to enter a password after unlocking

the player.

Request Pwd on Startup only [Switch Button]

If enabled, the password is only requested on startup after

unlocking the player.

Show Album Art as Wallpaper [Switch Button]

Launcher Button

Action [Option Button]

Launch Screen

Run Flash File

Special

Screen [Option Button]

*all available screens*

Flash File [Input Button]

The file you set here must be located in X:\Flash\ (where X:

is your Cowon player)




Special [Option Button]

Lock

Shutdown

Sleep

Widget Settings

Slideshow Widget [Subcategory Button]

Slideshow Widget

Use Slideshow Folder [Switch Button]

You can use a specific folder which contains pictures you

want to show as slideshow.

Requirements for this folder are:

- Two sub folders: '150x110' and '210x150'

- Must be located in X:\Pictures\ (where X: is your Cowon

player)

Set Slideshow Folder [Input Button]




7. Music/Radio Bar (+ integrated music player)

The way to use the regular music/radio bar isn't explained, it is easy enough.

The integrated music player:

In music mode you can use the integrated music player. Swipe up to open it.

The visibility state is saved; Example: If you go to another menubar page, the player is closed

automatically, and if you go back to the music bar, the music player is re-opened.

You can use the basic left/right swipe gestures to go to the next or previous track and tap

the album art to play/pause the music.

To see options for playback, eq and other things, tap the button with the arrow on the seek

bar.




II.2. Desktop Editor

You can start the Desktop Editor by pressing and holding an icon or widget until the buttons

in the menubar change and you can drag the icon or widget around.

The screenshot above shows how the Desktop Editor looks like.

The first button in the menubar opens the icon/widget menu, the second one exits the

Desktop Editor and the third one changes the grid. You can choose between a small grid, a

large grid and no grid. It has no effect on widgets.




The buttons at the bottom change when you drag an icon/widget.

If you drop the icon/widget over either one of the two arrows, the icon/widget is moved to

the next/previous desktop. If you drop it over the X, it is removed.




A useful feature is the possibility to create folders. Drop an icon over another one, and a

folders is created which contains both icons. To add another icon, you can drop it over the

folder, and to remove an icon from the folder, drag it out of the folder area (the black panel).

You can rename a folder using the 'edit title' button.

This feature works with icons and Custom Icons.




III. Advanced Features

III.1. Custom Icons

Custom Icons are icons not included in the UCI, or in other words: Custom Icons are user-

created icons.

The first thing you need is an icon in two variations: One with and one without label.

The naming scheme of these pictures is the following one:

The icon without label is '[name].png', the one with label '[name]__l.png'.

Put them into X:\System\Flash UI\Chakra\Custom Icons\ (where X: is your player).

Then open the file 'custom_icons.xml' in X:\System\Flash UI\Chakra\ with a text editor.

For every icon you have create an entry in <icons>...</icons> with the following scheme:

<icon name="name" type="type" file=" file" />

Name: A unique name for the custom icon

Type: 'Launcher', 'Flash' or 'Command'

File: Filename of the file the icon opens. If the type is 'Launcher', the file must be in

'System/Flash UI/', otherwise it has to be put into 'Flash/'.

Custom icons can be found in the icon menu.




III.2. PlugIns

PlugIns are small extensions for Chakra which can have various features.

There is for example the PlugIn 'Startup Actions' which allows you to start the music

playback on startup automatically. The PlugIn 'Wallpaper Changer' lets you assign a

wallpaper to a certain desktop or show random wallpapers.

The installation process is similar to the one of Custom Icons.

Usually, just extract the contents of the archive (which contains the PlugIn) into

X:\System\Flash UI\Chakra\PlugIns'.

Then, open the file 'plugins.xml' in X:\System\Flash UI\Chakra\ which may look like this:

<?xml version='1.0' encoding='utf-8'?>

<plugins>

<plugin file="event_interface.swf" />

<plugin file="wallpaper_changer.swf" />

</plugins>

Just add a new line between '<plugins>...</plugins>' and insert

<plugin file=" filename.swf" />

where filename is the filename of the plugin.




III.3. External Widgets

Usually, the archive the external widget contains has a folder in the root. Put this folder into

X:\System\Flash UI\Chakra\Widgets\.

If the widget is in the archive's root, create a new folder in in X:\System\Flash

UI\Chakra\Widgets\ and name it like the SWF file in the archive.

Example: SWF file name: 'widget.swf' -> folder name 'widget'.

Then open the file 'widgets.xml' in X:\System\Flash UI\Chakra\ and add a new line between

'<widgets>...</widgets>':

<widget id="id " /> (where 'id' is the widget's folder name)

Example: You installed a new widget 'test'. Then the line you add to the XML file must be

'<widget id="test" />'.




IV. PlugIn Documentation

IV.1. Wallpaper Changer

Wallpapers have to be put into X:\System\Flash

UI\Chakra\PlugIns\res__wallpaper_changer.swf\ and can be JPG or PNG files.

Open XML file 'wallpapers.xml' in X:\System\Flash

UI\Chakra\PlugIns\res__wallpaper_changer.swf\ and add for each wallpaper the followingline between <wallpapers></wallpapers>:

<wallpaper file=" filename" />

In order to assign a wallpaper to a certain desktop, just add 'desktop="N"' to the wallpaper's

entry you want to assign to a desktop. N is the number of the desktop.

Example:

<?xml version='1.0' encoding='utf-8'?>

<wallpapers>

<wallpaper file="download.jpg" desktop="3" />

<wallpaper file="fgd4r346.jpg" />

<wallpaper file="Find_your_way_1280 x 960.jpg" desktop="1" />

</wallpapers>

chakra readme v1.0

Documents