Ion3 scripts collection

Plase note that some of the scripts are not up to date, and do not work with the latest version. Those that are known to need working, are over-striked. Please fix them, if you need them.

• Scripts
• Key bindings
• Styles
• Statusbar monitors
• Instructions → Using, Downloading, Contributing

Scripts

adapt_menus.lua

Functions for creating a hierarchy of menus for various clients available. Key features are an attempt to organise by type hints (from the window titles) and collapse submenus when they contain only a few items.

alt_resize.lua

Possibly more intuitive resizing bindings.

app.lua

Start an application if it's not running, but go to it if it's already started. There's also a function to replace query_editfile which will use a running emacs instance (starting it if necessary, of course).

autoprop.lua

Automatically create a winprop for the given client targeted to the given frame. Allows them to be saved and reloaded automatically.

bindsearch.lua

Search the current bindings table by key or by command.

bookmarks.lua

Bookmarks support

cfg_dock2.lua

A dock configuration with lots of added control.

closeorkill.lua

Kill client on second close try if it did not respond to close

collapse.lua

Collapse frames on a WTiling into a single frame

ctrl_statusbar.lua

Menu-driven controller for the statusbar. Modules can be enabled/ disabled from the menu, without requiring to edit the configuration file.

cwin_sp.lua

Create per-clientwin scratchpads

document_menus.lua

Navigate the filesystem using ion menus.

enumerate.lua

Adds "X." in front of the client windows, which may make switching between client-windows with MOD+n a little easier .

environment_placement_hook.lua

Linux-only placement hook which detects the presence of an ION_USE_WS environment variable in the processes of new windows, and uses that to determine where to place them.

exec_show.lua

Execute some shell-command (tail, head, grep etc) and display the result.

frame_client_menu.lua

Adds a 'Client windows' submenu to a frame's context menu, the menu contains all the clients in the current frame.

go_frame_or_desk.lua

selects frame in the specified direction. If there is no frame at that location, instead the next workspace in the direction becomes active

goto_multihead.lua

A version of goto_dir that may be useful on multihead setups.

heuristics.lua

Window placement heuristics for tiled workspaces

histcompl.lua

History completion support for the line editor

lock_frame.lua

'Lock' selected frames so they don't close via the keyboard.

min_tabs.lua

Show tabs precisely when two or more windows in an ion frame

move_current.lua

Move current window in a frame to another frame in specified direction

mp.lua

Mark next mapped window to be attached to a specified object

mpd.lua

Control a MusicPD server from within Ion

named_floating_groupws.lua

Toggle (and create) floating WGroupWS:s by name.

named_scratchpad.lua

Toggle (and create) scratchpads by name.

nest_ws.lua

Attach workspaces to windows, to e.g. have a WIonWS inside a WFloatWS, or vice versa

nextact.lua

Go to first found region with activity flag set.

nowarp_scratchpad.lua

Keeps ion from warping the pointer when activating a scratchpad region.

query_url.lua

Open a URL, completing on Opera bookmark file. Should be easy to support other browsers.

rotate_statusbar.lua

Rotate the statusbar between different templates. This will automatically load all of the modules for ion-statusd.

rss_feed.lua

A simple rss-reader script in lua for ion.

rss_feed_hh.lua

Some small improvements to match rss_feed my personal taste.

schedule.lua

Schedule some messages to show up at specified times in the statusbar.

send_to_ws.lua

Quickly send to another workspace.

stock.lua

An applet for retrieving and displaying stock market information from http://finance.yahoo.com. You can set up a portfolio and monitor its intraday performance.

switch_bindings.lua

Switch between key-bindings. You can temporarily disable keybindings and restore them later when necessary.

weather.lua

This script allows you to retreive weather information from one or more weather observation stations and display it in the statusbar.

xinerama_switcher.lua

This is similar to (and base on) go_frame_or_desk.lua but adds the ability to move between screens too. Left/right switch between screens, up/down between workspaces.

xkbion.lua

This script allows you to use independent keyboard layouts for different windows in Ion3. It uses a window property to store the XKB groups, so you can restart Ion without losing settings for each window.

zoom.lua

Simulates larswm-like window zooming.

Key bindings

cfg_mouse.lua

Make the mouse pull its weight in ion.

dans_bindings.lua

Keybindings for more intuitive WIonWS navigation.

emacs_bindings.lua

Emacs-like keybindings for Ion

vim_bindings.lua

Vim-like keybindings for Ion queries.

Styles

look_alex.lua

Black tabs, green text and borders.

look_asm.lua

A clean grey-blue theme with not too big tabs.

look_atme.lua

A style which just looks nice.

look_awesome.lua

Inspired by look_clean, comes fully-equipped with big, friendly tabs, tasty single-pixel borders, and a sprinkling of transparency. Makes use of the Terminus font.

look_awesome_sm.lua

A style based on look_awesome above, but with smaller fonts and paddings and no transparency by default. This style makes use of the 'nexus' font for tabs.

look_awesome_yaarg.lua

A style based on look-awesome-sm above, but with darker colours to give a more somber feel.

look_bas.lua

A style which colors fit the mozilla-bb background. It makes use of the techy artwiz font.

look_blue.lua

A blue/gray theme based on look_violet.lua, with a nice clean look.

look_bluecurve.lua

A theme that fits the colors of the bluecurve-theme by Redhat

look_cleanpastel.lua

Similar to stock look-clean* styles, but greenish.

look_cleansteel.lua

The stock look-brownsteel style with borders removed on tiled workspaces for cleaner look.

look_cleanwhite.lua

A bright theme that fits white terminals and white Emacs windows.

look_cool.lua

A style based on look-awesome, made to fit the KDE color scheme "plastic-grey". Made by Steffen Liebergeld (26.08.2004).

look_gtk2.lua

A theme that fits the default GTK+2 colors. It makes use of the terminus and artwiz fonts.

look_minimalist.lua

A simple gold/red style with relatively large frame borders designed to increase usability with the minimal tabs modification.

look_moy.lua

Grey and violet simple theme.

look_ootput.lua

A non-obtrusive style with clear distinctions between active borders and less active borders. This style makes use of the Profont font.

look_qt.lua

A drawing engine configuration file that reads settings from Qt configuration file ~/.qt/qtrc.

look_tibi.lua

A style which clearly emphasizes active elements and thus lets you quickly recognize them. The `accent' color is configurable.

look_tiny.lua

A major modification of look_minimalist, aiming to keep everything small while not making anything unattractive.

look_tiny_min_tabs.lua

A major modification of look_minimalist, aiming to keep everything small while not making anything unattractive. For use with min_tabs.

look_whitecode.lua

Clean white/light grey theme. Comes handy for glare displays as reflection is not as evil as with a dark theming. I recommend background color #808080 for a cool look in floating workspaces. (Tested only on my LCD, so no idea what it looks like on a CRT)

Statusbar

Internal monitors

statusbar_act.lua

Activity (urgency flag, new unacted-upon transients, etc.) display for the statusbar.

statusbar_external.lua

Show output of external programs or scripts in statusbar. If you are using ion-3ds-20060107 or later, using statusd_exec.lua instead of this old version is suggested.

statusbar_workspace.lua

Show current workspace name in statusbar, or a list of workspace numbers with the active one indicated.

statusbar_wsname.lua

Shows the current workspace name in the statusbar, can also show a list of workspaces and indicate the current one. The current workspace indicator is customizable. This script also allows for per-head workspace information.

Ion-statusd monitors

statusd_amarok.lua

Ion-statusd monitor reporting the current song or status of amaroK. Uses dcop.

statusd_apm.lua

Ion-statusd monitor reporting APM status; works on OpenBSD 4.0 by executing external program every minute. Now with hints for battery state and external A/C connection.

statusd_apm2.lua

Ion-statusd monitor reporting APM status; works on FreeBSD by executing apm as an external program every minute. Added hints for a bit more color. Even though this is apm2, save it as statusd_apm.lua.

statusd_batt.lua

Ion-statusd monitor reporting battery status; works with apm.

statusd_binclock.lua

Ion-statusd binary clock in two possible modes: Plain binary (numbers) and character mode (dots, lines, etc).

statusd_bsdbatt.lua

Ion-statusd monitor for FreeBSD ACPI CMBATT status. Uses the sysctl interface.

statusd_cpufreq.lua

Ion-statusd monitor reporting current CPU speed in KHz, MHz, or GHz. Uses the /proc filesystem and cpufreq.

statusd_cpuspeed.lua

Ion-statusd monitor reporting current CPU speed; works with apm.

statusd_cpustat.lua

Ion-statusd monitor reporting current CPU stats using the Linux /proc/stat interface.

statusd_df.lua

Ion-statusd monitor reporting free disk space. Depends on df.

statusd_dgs.lua

Ion-statusd monitor reporting on any games waiting for a move on www.dragongoserver.net.

statusd_exec.lua

Show output of external programs or scripts in statusbar. Uses non-blocking reads and can be used with both continously outputting and periodically run programs. Allows highlighting with regexp matching.

statusd_flashing.lua

Ion-statusd multi-purpose monitor. Show blinking alarms when some defined files or directories have changed. It can be used to monitor email inboxes, security logs, etc.

statusd_fortune.lua

Ion-statusd monitor displaying fortunes.

statusd_iface.lua

Ion-statusd monitor reporting currently used network interface.

statusd_inetaddr.lua

Ion-statusd monitor reporting current IP address from ifconfig.

statusd_info.lua

Ion-statusd monitor reporting current CPU, RAM, and swap usage. Depends on top and free.

statusd_iwinfo.lua

Ion-statusd monitor reporting minimal wireless info.

statusd_laptopstatus.lua

Ion-statusd monitor reporting CPU speed & temperature and battery status; works with acpi.

statusd_linuxbatt.lua

Ion-statusd monitor reporting battery percentage and status using the Linux /proc/acpi interface.

statusd_maildir.lua

Ion-statusd monitor showing mailcount of a Maildir.

statusd_mem.lua

Ion-statusd monitor reporting current memory usage with selective alarms and non blocking I/O. Depends on Linux free command.

statusd_meminfo.lua

Ion-statusd monitor reporting current memory and swap usage. Depends on the Linux /proc/meminfo interface.

statusd_moc.lua

Ion-statusd monitor reporting moc information and status.

statusd_mocmon.lua

Ion-statusd monitor reporting moc information. This is actually just a modification of statusd_xmmsip.lua using the idea of non-blocking I/O as shown in statusd_mocp.lua.

statusd_mocp.lua

Ion-statusd monitor reporting moc status. This is a stripped down, non-blocking I/O version of the above. It is useful with rotate_statusbar.lua.

statusd_mpd.lua

Ion-statusd monitor reporting mpd information and status.

statusd_netmon.lua

Ion-statusd network monitor reporting network activity.

statusd_nmaild.lua

Ion-statusd Maildir monitor with selective alarms, counters for different filters and optional command launcher when a new email is detected.

statusd_orpheus.lua

Ion-statusd monitor reporting song currently being played by orpheus.

statusd_pytone.lua

Ion-statusd monitor reporting song currently being played by pytone.

statusd_sysmon.lua

Ion-statusd monitor for reporting various system resources.

statusd_ticker.lua

Ion-statusd monitor which scrolls the output of specified programs.

statusd_uname.lua

Ion-statusd monitor for reporting uname. It is primarily a simple example of how to use statusd.popen_bgread() with coroutines for non-blocking I/O.

statusd_uptime.lua

Ion-statusd monitor reporting the system uptime.

statusd_volume.lua

Ion-statusd monitor reporting sound volume values (currently, master and pcm). Depends on aumix.

statusd_volume2.lua

Ion-stadusd monitor reporting master sound volume and state (on or muted). Depends on amixer. Despite being named "statusd_volume2.lua", the script needs to be relabeled "statusd_volume.lua" to work.

statusd_xmms.lua

Ion-statusd monitor reporting song currently selected in xmms' playlist.

statusd_xmmsip.lua

Ion-statusd monitor(s) reporting information from a xmms-infopipe-plugin's pipe. Can be customized in various ways.

Instructions

Using

1. Create the directory ~/.ion3/, if it does not exist yet.
2. Copy the script in this directory.
3. Depending on the type of script, do the following.

   Proper scripts

   Copy cfg_ion.lua in ~/.ion3/, if it does not contain one already. This file can usually be found in either /usr/local/etc/ion3/ or /etc/X11/ion3/. Then add the suitably modified line

   dopath("name of script without extension")
   

   at the end of the file (in ~/.ion3/).

   Statusbar

   Make sure you have cfg_statusbar.lua in ~/.ion3/, and add one of the monitors provided by the script in the template.

   Styles

   That's it. You can choose styles/refresh-list from the F12 main menu to have a running instance of Ion find it, and then choose the style from the same menu.

Downloading a copy

darcs get http://iki.fi/tuomov/repos/ion-scripts-3/

To update a previously downloaded repository, use darcs pull. The command darcs changes can be used to view the list of changes, and there is also an RSS feed of the most recent changes.

Contributing

1. Get a copy of the repository as explained above.
2. Repeat as many times as you want to:
   1. Make your changes and put new files in the proper directories inside your copy of the repository. Use the command darcs add filename to put newly added files under version control.
   2. Update this index.html to link to any added files, in alphabetical order.
   3. Record your changes to your local copy of the repository with the command darcs record -a.

      The first time you do this, darcs will prompt for your email address. The preferred format is Your real name <user@host>. The address should not be visible on a linked-to page unencrypted. The name of the patch is a short one-line summary of your changes.

      Because I use an UTF-8 locale (for now), you must also run this command in an UTF-8 locale or stick to plain ASCII in your input, because darcs stubbornly does not support locales with some of the developers instead preferring an UTF-8 monoculture that we will be suffering from for ages to come. Yes, I have considered switching to another VCS.

3. Send your patches to me by email with the command darcs send. I will apply them to the online repository if they look okay.

   If you can't for some reason send this way, use the -o option and send the output file normally as an attachment. Please begin the subject line with 'darcs patch'. Only the patch bundles generated by darcs send are acceptable; do not send anything else. I refuse to go through the trouble of applying plain-old-diffs and documenting them in the change log.