Auxlaunch

From Openmoko

(Difference between revisions)
Jump to: navigation, search
m (Installation)
(Many chnages for ver 0.5)
Line 1: Line 1:
Auxlaunch is a very simple, finger-friendly application launcher and window switcher for the Freerunner. It appears when the "AUX" button is pressed. The top buttons change when the up/down buttons below are pressed.
+
Auxlaunch is a simple, "finger-friendly" app launcher and optional window-switcher. It appears when the "AUX" button is pressed. The top button changes when the buttons below are pressed.<br>  
<br><br>
+
<br>
  
 
__TOC__
 
__TOC__
Line 6: Line 6:
 
== Operation ==
 
== Operation ==
  
To launch an app, press the top left button. To switch to a currently running app (window), press the top right button. Use the arrow keys in the 2nd and 3rd row to change the launch or window-switch buttons above them.
+
Use the top button to launch an application, enter a group (menu), or switch to another window. To cycle through apps, groups, or windows, press the buttons below.<br>
 +
<br>
 +
The top button changes function based on the most recently used adjust (arrow) buttons.<br>
 +
<br>
 +
The app launch items are configured in a comma delimited text file (.auxlaunchrc). Items such as "Suspend", "Cancel", and "Quit" can be configured too. Auxlaunch uses stock GTK icons or images from files.<br>
 +
<br>
 +
Note: Auxlaunch is, of course, very beta and, so far, only tested in Debian.
  
The launch items are configured in a comma delimited text file (.auxlaunchrc). Items such as "Suspend", "Cancel", and "Quit" can be configured too. Auxlaunch uses stock GTK icons or images from files.
+
== Configuration ==
  
Note: Auxlaunch is, of course, very beta and, so far, only tested in Debian.
+
Edit the ".auxlaunch" file.<br>
 +
<ol>
 +
<li>Create a new group (for items that follow) with a line containing group name in quotes followed by a comma.</li>
 +
<li>For item icons, specify a stock GTK icon identifier or a path to an existing image.</li>
 +
<li>Use " &" at end of command to run in background.</li>
 +
</ol>
  
 
== Options ==
 
== Options ==
  
Command line options include:
+
Use: "auxlaunch -option1 -option2". Command line options include:
  
 
<ul>
 
<ul>
<li>"-nowm" hides the window-switching buttons.</li>
+
<li>-dms = Include items from Debian Menu System.</li>
<li>"-right" swaps button columns (left/right).</li>
+
<li>-nowm = No window manager. (Do not show window switching buttons).</li>
<li>"-dms" creates additional items from Debian Menu System (only those that specify needs="x11")</li> </ul>
+
<li>-right = Swap app-launchning and window-switching buttons (right for left).</li>
 +
<li>-hide = Cause AUX button to hide Auxlaunch (when it is displayed).</li>
 +
<li>-simple = Use "change" buttons for grp/app/win selecting (instead of up/down buttons).</li>
 +
</ul>
  
 
== Installation ==
 
== Installation ==
Line 25: Line 39:
 
Python and PyGTK are required. Package "wmctrl" is required for window (app) switching.
 
Python and PyGTK are required. Package "wmctrl" is required for window (app) switching.
  
[http://aliasid.googlepages.com/auxlaunch-0.4.tar.gz Download] (from external site)
+
[http://aliasid.googlepages.com/auxlaunch-0.5.tar.gz Download] (from external site)
  
 
<ol>
 
<ol>
<li>Extract files to new directory.</li>
+
<li>Extract all files to new directory.</li>
<li>Edit .auxlaunchrc</li>
+
<li>At command line, run "./auxlaunch".</li>
<ul>
+
<li>Specify stock GTK icon identifiers -or- file names of existing images.</li>
+
<li>Use "&" at end of command to run as a separate process (usually a good idea).</li>
+
</ul>
+
<li>At command line, run "./auxlaunch <options> &". </li>
+
 
<li>Press AUX button and enjoy!</li>
 
<li>Press AUX button and enjoy!</li>
 
</ol>
 
</ol>
  
== Screenshot ==
+
== Screenshots ==
  
Auxlaunch shown here underneath the cool, "openmoko-panel-plugin':
+
Auxlaunch shown here in normal and "simple" modes. Both shown underneath the cool "openmoko-panel-plugin':
<br>
+
(Also, yeah, it is kind of silly to configure Auxlaunch with an "Auxlaunch" button. But I thought it'd make for a good screenshot.)
+
 
<br><br>
 
<br><br>
  
[[Image:Auxlaunch-screenshot.png]]
+
[[Image:Auxlaunch-screenshot-1.png]]
 +
 
 +
[[Image:Auxlaunch-screenshot-2.png]]
 +
 
 +
== Latest Changes (for Version 0.5) ==
 +
 
 +
<ul>
 +
<li>Moved to using single, top-level, 'go" button for app-launch, group-change, win-switch.</li>
 +
<li>Added "group" feature to provide menu-like associations of apps. (For now, only one level.)</li>
 +
<li>Made DMS file parsing slightly more robust.</li>
 +
<li>Added "-hide" options to integrate Ben's AUX-button-minimize feature.</li>
 +
<li>Added "-simple' feature to simplify user interface.</li>
 +
<li>Reorganized code to try Model-View-Controller paradigm.</li>
 +
<li>More code comments!</li>
 +
<li>General code rewrite.</li> 
 +
</ul>
  
 
[[Category:System Applications]]
 
[[Category:System Applications]]

Revision as of 19:28, 26 October 2008

Auxlaunch is a simple, "finger-friendly" app launcher and optional window-switcher. It appears when the "AUX" button is pressed. The top button changes when the buttons below are pressed.

Contents


Operation

Use the top button to launch an application, enter a group (menu), or switch to another window. To cycle through apps, groups, or windows, press the buttons below.

The top button changes function based on the most recently used adjust (arrow) buttons.

The app launch items are configured in a comma delimited text file (.auxlaunchrc). Items such as "Suspend", "Cancel", and "Quit" can be configured too. Auxlaunch uses stock GTK icons or images from files.

Note: Auxlaunch is, of course, very beta and, so far, only tested in Debian.

Configuration

Edit the ".auxlaunch" file.

  1. Create a new group (for items that follow) with a line containing group name in quotes followed by a comma.
  2. For item icons, specify a stock GTK icon identifier or a path to an existing image.
  3. Use " &" at end of command to run in background.

Options

Use: "auxlaunch -option1 -option2". Command line options include:

  • -dms = Include items from Debian Menu System.
  • -nowm = No window manager. (Do not show window switching buttons).
  • -right = Swap app-launchning and window-switching buttons (right for left).
  • -hide = Cause AUX button to hide Auxlaunch (when it is displayed).
  • -simple = Use "change" buttons for grp/app/win selecting (instead of up/down buttons).

Installation

Python and PyGTK are required. Package "wmctrl" is required for window (app) switching.

Download (from external site)

  1. Extract all files to new directory.
  2. At command line, run "./auxlaunch".
  3. Press AUX button and enjoy!

Screenshots

Auxlaunch shown here in normal and "simple" modes. Both shown underneath the cool "openmoko-panel-plugin':

File:Auxlaunch-screenshot-1.png

File:Auxlaunch-screenshot-2.png

Latest Changes (for Version 0.5)

  • Moved to using single, top-level, 'go" button for app-launch, group-change, win-switch.
  • Added "group" feature to provide menu-like associations of apps. (For now, only one level.)
  • Made DMS file parsing slightly more robust.
  • Added "-hide" options to integrate Ben's AUX-button-minimize feature.
  • Added "-simple' feature to simplify user interface.
  • Reorganized code to try Model-View-Controller paradigm.
  • More code comments!
  • General code rewrite.
Personal tools

Auxlaunch is a very simple, finger-friendly application launcher and window switcher for the Freerunner. It appears when the "AUX" button is pressed. The top buttons change when the up/down buttons below are pressed.

Contents


Operation

To launch an app, press the top left button. To switch to a currently running app (window), press the top right button. Use the arrow keys in the 2nd and 3rd row to change the launch or window-switch buttons above them.

The launch items are configured in a comma delimited text file (.auxlaunchrc). Items such as "Suspend", "Cancel", and "Quit" can be configured too. Auxlaunch uses stock GTK icons or images from files.

Note: Auxlaunch is, of course, very beta and, so far, only tested in Debian.

Options

Command line options include:

  • "-nowm" hides the window-switching buttons.
  • "-right" swaps button columns (left/right).
  • "-dms" creates additional items from Debian Menu System (only those that specify needs="x11")

Installation

Python and PyGTK are required. Package "wmctrl" is required for window (app) switching.

Download (from external site)

  1. Extract files to new directory.
  2. Edit .auxlaunchrc
    • Specify stock GTK icon identifiers -or- file names of existing images.
    • Use "&" at end of command to run as a separate process (usually a good idea).
  3. At command line, run "./auxlaunch <options> &".
  4. Press AUX button and enjoy!

Screenshot

Auxlaunch shown here underneath the cool, "openmoko-panel-plugin':
(Also, yeah, it is kind of silly to configure Auxlaunch with an "Auxlaunch" button. But I thought it'd make for a good screenshot.)

Auxlaunch-screenshot.png