Auxlaunch

From Openmoko

(Difference between revisions)
Jump to: navigation, search
m
 
(25 intermediate revisions by one user not shown)
Line 1: Line 1:
Auxlaunch is a very simple, finger-friendly application launcher 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 window-switcher. It (optionally) appears when the "AUX" button is pressed. The top on-screen button changes function when the on-screen buttons below are pressed.<br>
 +
<br>
  
To launch an app, press the top left button ("left for launch"). The apps 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.
+
__TOC__
  
To switch to a currently running app (window), press the top right button. If you don't like this feature, then specify "-nowm" when running "auxlaunch" (i.e. "auxlaunch -nowm"). This will hide the right-hand, app switching buttons.
+
== Operation ==
  
Python and PyGTK are required. Package "wmctrl" is required for window (app) switching. A screenshot (shown along with the cool openmoko-panel-plugin) is below.
+
Use the top, on-screen button to launch an application, enter a menu group, or switch to another window. To cycle through apps, groups, or windows, press the on-screen 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) in the user's home directory. 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 beta may be a bit rough around the edges. :-)
 +
<br>
 +
== Configuration ==
  
Note: Auxlaunch is, of course, beta and, so far, only tested in Debian.
+
Edit the "~/.auxlaunchrc" file.<br>
 +
<ol>
 +
<li>Create a new menu 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 "(quit)", "(cancel)", or "(reload)" to create items to hide Auxlaunch, stop Auxlaunch, or reread Auxlaunch's configuration.
 +
<li>Use a "-" in the first column to indicate titles of windows that should not appear in the window-switching list.</li>
 +
</ol>
 +
<br>
  
[http://aliasid.googlepages.com/auxlaunch-0.3.tar.gz Download]
+
== Options ==
  
[[Image:auxlaunch-screenshot.jpg]]
+
Use: "auxlaunch -option1 -option2". Command line options include:
 +
 
 +
<ul>
 +
<li>-dms    = Include items from Debian Menu System.</li>
 +
<li>-nowm  = No window manager. (Do not show window switching buttons).</li>
 +
<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>
 +
<li>-noaux  = Do not react to AUX button. (Run auxlaunch again to unhide.)</li>
 +
</ul>
 +
<br>
 +
== Installation ==
 +
 
 +
Python and PyGTK are required. Package "wmctrl" is required for window (app) switching. If installing by hand, make sure to place the ".auxlaunchrc" file in your  home directory.
 +
 
 +
[http://code.google.com/p/auxlaunch/downloads/list Download] (from external site)
 +
 
 +
== Screenshots ==
 +
 
 +
Auxlaunch shown here in normal and "simple" modes. Both shown underneath the cool "openmoko-panel-plugin" app:
 +
<br><br>
 +
 
 +
[[Image:Auxlaunch-Screenshot-1.png]]
 +
 
 +
[[Image:Auxlaunch-Screenshot-2.png]]
 +
<br>
 +
== Latest Changes ==
 +
 
 +
<b>Version 0.6</b>
 +
<ul>
 +
<li>Changed code to open rc file in user's home directory.</li>
 +
<li>Changed app launch code to use fork and execvp.</li>
 +
<li>Fixed bug where mode not set to WIN on gaining focus</li>
 +
<li>Added '-noaux' feature as alternative to claiming the aux button.</li>
 +
<li>Added code to enforce single instance and signal any currently running auxlaunch process.</li>
 +
<li>Started using version control (at http://code.google.com/p/auxlaunch/).</li>
 +
<li>Removed pesky /r's. Thanks to Timo for the alert.</li>
 +
<li>DMS: Shortened 'Applicatons' to 'Apps'</li>   
 +
</ul>
 +
<br>
 +
<b>Version 0.5-2</b>
 +
<ul>
 +
<li>Added license, comments, and file for GPL.</li>
 +
<li>Fixed bug where "go" button was hardcoded to 3 columns.</li>
 +
<li>Added window title filtering ('-' in first column of rc file).</li>
 +
<li>Added chrysn's '(reload)' feature.</li>
 +
</ul>
 +
<br>
 +
<b>Version 0.5</b>
 +
<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]]

Latest revision as of 21:38, 30 November 2008

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

Contents


[edit] Operation

Use the top, on-screen button to launch an application, enter a menu group, or switch to another window. To cycle through apps, groups, or windows, press the on-screen 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) in the user's home directory. Items such as "Suspend", "Cancel", and "Quit" can be configured too. Auxlaunch uses stock GTK icons or images from files.

Note: Auxlaunch is beta may be a bit rough around the edges. :-)

[edit] Configuration

Edit the "~/.auxlaunchrc" file.

  1. Create a new menu 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 "(quit)", "(cancel)", or "(reload)" to create items to hide Auxlaunch, stop Auxlaunch, or reread Auxlaunch's configuration.
  4. Use a "-" in the first column to indicate titles of windows that should not appear in the window-switching list.


[edit] 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).
  • -noaux = Do not react to AUX button. (Run auxlaunch again to unhide.)


[edit] Installation

Python and PyGTK are required. Package "wmctrl" is required for window (app) switching. If installing by hand, make sure to place the ".auxlaunchrc" file in your home directory.

Download (from external site)

[edit] Screenshots

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

Auxlaunch-Screenshot-1.png

Auxlaunch-Screenshot-2.png

[edit] Latest Changes

Version 0.6

  • Changed code to open rc file in user's home directory.
  • Changed app launch code to use fork and execvp.
  • Fixed bug where mode not set to WIN on gaining focus
  • Added '-noaux' feature as alternative to claiming the aux button.
  • Added code to enforce single instance and signal any currently running auxlaunch process.
  • Started using version control (at http://code.google.com/p/auxlaunch/).
  • Removed pesky /r's. Thanks to Timo for the alert.
  • DMS: Shortened 'Applicatons' to 'Apps'


Version 0.5-2

  • Added license, comments, and file for GPL.
  • Fixed bug where "go" button was hardcoded to 3 columns.
  • Added window title filtering ('-' in first column of rc file).
  • Added chrysn's '(reload)' feature.


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 for the Freerunner. It appears when the "AUX" button is pressed. The top buttons change when the up/down buttons below are pressed.

To launch an app, press the top left button ("left for launch"). The apps 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.

To switch to a currently running app (window), press the top right button. If you don't like this feature, then specify "-nowm" when running "auxlaunch" (i.e. "auxlaunch -nowm"). This will hide the right-hand, app switching buttons.

Python and PyGTK are required. Package "wmctrl" is required for window (app) switching. A screenshot (shown along with the cool openmoko-panel-plugin) is below.

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

Download

File:Auxlaunch-screenshot.jpg