Iliad Toolbox v1.2
==================

Copyright (C) 2009  Iñigo Serna <inigoserna@gmail.com>
Released under GPL3+
Time-stamp: <2009-11-22 22:55:33 inigo>


Iliad Toolbox is a set of some useful applications for your Iliad.


Tools:
======
- System Information
  Show information about: cpu, memory, battery, uptime, load, disks,
  and running processes.
- Network Information (NOT written yet)
  Show network information. Start/stop network and/or SSH server.
- File Explorer
  File system navigation. Consult next section.
- Recent Files
  It lets you to delete some old entries in Recent Files that may
  pollute the list.
- System Operations
  Power-off or Reboot the Iliad.
- Help
  Show this documentation.
- About
  Credits and thanks.

  
Better take a look at the screenshots to get an idea.


File Explorer:
==============
File Explorer is a browser for the files in the Iliad.

Some features:
- flat view or tree view
- copy, move or delete files and directories
- bookmarks
- highly configurable
- controlled with the stylus

Preferences:
------------
Preferences are loaded at start and saved at exit.
You can change these options:
- flat vs. tree view (select depth from 1 to 5 levels).
  Default treeview, with depth 3
- start path
- 10 bookmarks

User interaction:
-----------------
- tree view
  . click on any other column of row: expand/collapse row
- common for flat and tree views
  . click on <dir> (type column) to change folder
  . first column: cycle among selected/copied/cut states. See below
  
Files selection: copying, moving and deleting
---------------------------------------------
File Explorer uses copy, cut and paste paradigm to copy, move
and delete files and folders. 

To select files:
- click on first column in the flat or tree views
  . only files in user folders can be selected.
    That's to avoid damage to system files and thus hurt the Iliad
  . changing folder does not affect selected files
  . to change from selected to copy or cut or unselected click-cycle column
- use the menu

To copy files:
- select the files and mark them as copy to clipboard
- navigate to the destination folder and paste

To move files:
- select the files and mark them as cut to clipboard
- navigate to the destination folder and paste

To delete files:
- select the files
- click on delete

Menus:
------
- actions
  . copy to clipboard: will copy these files after paste
  . cut to clipboard: will move these files after paste
  . paste (from clipboard): perform move or copy files,
    depending on their state (copy or cut)
  . delete: remove selected files from the Iliad.
    Copied & cut files won't be deleted
  . clear selected files: clear selected/copied/cut files list
  . view selected files: display selected files and their state
- view & selections
  . expand all rows
  . expand 1 level
  . collapse all rows
  . select all: select files
  . select all & copy: select files and mark as copied
  . select all & cut: select files and mark as cut
  
Command Line:
-------------
you can pass some arguments when running from CLI:
$ lua /path/to/filebrowser.lua [-f|-t] [path] | /path/to/xx -p

Miscellaneous:
--------------
- you can click on any part of the paths to navigate to that folder
  f.e. if you are in /media/card/books clicking with the stylus over
       the word "card", you will change the current folder to
       /media/card
  This behaviour also exists in preferences and other parts of the program.
  A clever feature, isn't it?
- note that:
  . if destination folder contains files with the same name that the ones
    you are copying or moving, they will be silently overwritten
  . items in copied or cut states will not be deleted, only those
    on selected state
- it's hard to click on '/' in path


Code:
=====
Iliad Toolbox has been written in Lua language and uses lgob (gtk+
bindings for lua), both compiled and packaged for Iliad by Great
Hansel. Display refresh is handled by Hansel's xx, a small program
based on Antartica's xepdmgr.
You don't need to install them separately because they are included
with the package (and in fact that's the reason it's so big).

Icons come from BlackSecret theme for GNOME Desktop.


Installation:
=============
To install, uncompress, copy on your Iliad and run the installer from
the ContentLister.
To upgrade, delete the old version and proceed to install again.
Btw, the install method has been created by Hansel as well.


Using Iliad Toolbox:
====================
You need to use the stylus to click.
The X on windows top-left purpose is to close each window.


Of course, all feedback, ideas and suggestions are welcome.


Todo:
=====
- file explorer
  . some random crashes after deleting, copying or moving files
  . ui_clipboard: button to unselect file
  . click on "/" path is difficult
  . new actions: rename, make_dir, find, show_details/properties,
                 dir_size, view_file, open_file
- network module: info, on/off, dropbear on/off
- rewrite recentfiles
- modify install procedure (?)
- led doesn't blink: it looks xx disables it
