Instantlauncher - navigate to your files and programs quickly!
-Table of Contents
- -+
Instantlauncher - navigate to your files and programs quickly!
+-
-
- download latest snapshot +
- download latest snapshot +
- This program is free software; you can redistribute it and/or modify it under the terms of version 3 of the GNU Lesser General Public License or later as -published by the Free Software Foundation. +published by the Free Software Foundation. +
- Program author:
-
-
- Svjatoslav Agejenko -
- Homepage: http://svjatoslav.eu/ -
- Email: mailto://svjatoslav@svjatoslav.eu/ -
-
- - other applications hosted at svjatoslav.eu +
- Svjatoslav Agejenko + +
- Homepage: http://svjatoslav.eu + +
- Email: mailto://svjatoslav@svjatoslav.eu +
1 General description
+1 General description
-Quick filesystem based document/application launcher. It starts by showing -content of predefined directory. Sub directories can be chosen by simply moving -mouse pointer over corresponding directory. +Quick filesystem based document/application launcher. It starts by +showing content of predefined directory. Sub directories can be chosen +by simply moving mouse pointer over corresponding directory.
-+
Files types are color-coded. @@ -196,71 +242,222 @@ Files types are color-coded.
2 Usage
+2 Usage
+Simply hovering mouse pointer over directory expands its contents in +the next right column. +
+ +-
-
- Executable file: +
- Executable file (red):
- Left mouse click:
-
-
- Run executable file. -
+ - Run executable file. + +
- Left mouse click:
- Right mouse click:
-
-
- Toggle executable state. -
-
- Left mouse click:
-
-
- Open file using corresponding application. -
+ - Open file using corresponding application. + +
-
-
- Toggle executable state. -
- Left mouse click:
-
-
- Open directory using configured filesystem browser. -
+ - Open directory using configured filesystem browser. + +
-
-
- Open directory using configured text based terminal emulator. -
3 Configuration
+3 Configuration
-TODO: +When instantlauncher starts, it looks for configuration file under
++~/.instantlauncher ++ +
+If file is not found, it creates new default configuration file in +YAML format: +
++!configuration +directoryOpenCommand: nautilus -w {file} +directoryTerminalOpenCommand: gnome-terminal --working-directory={file} +fileAssociations: +- command: vlc {file} + fileRegex: .*\.mkv$ +- command: emacs {file} + fileRegex: .*\.txt$ +- command: eog {file} + fileRegex: .*\.jpeg$ +- command: eog {file} + fileRegex: .*\.png$ +- command: vlc {file} + fileRegex: .*\.avi$ +- command: vlc {file} + fileRegex: .*\.mp4$ +- command: eog {file} + fileRegex: .*\.jpg$ +- command: emacs {file} + fileRegex: .*\.org$ +navigationRootPath: /home/svjatoslav/ ++
3.1 directoryOpenCommand
++Command to use when opening directory. +
+ ++By default instantlauncher assumes that Gnome desktop environment is +installed and uses Nautilus file manager: +
++directoryOpenCommand: nautilus -w {file} ++
3.2 directoryTerminalOpenCommand
++Command to use when opening directory in text terminal based console. +
+ ++By default instantlauncher assumes that Gnome desktop environment is +installed and uses Gnome Terminal: +
+ ++directoryTerminalOpenCommand: gnome-terminal --working-directory={file} ++
3.3 fileAssociations
++Allows to map file name/extension using regular expression pattern +matching to corresponding application. +
+ ++Example: +
+- command: vlc {file} + fileRegex: .*\.mkv$ ++
+Where: +
+-
+
- command
- Command to execute to open given file. Special variable +{file} will point to user chosen file using absolute file +path. + + +
- fileRegex
- Regular expression that must match the file. + +
3.4 navigationRootPath
++Root directory from where to start navigation. +
+ ++This parameter is user specific! In my case instantlauncher by default +pointed this to my home directory. But it can be any directory user +chooses. +
-4 TODO
--TODO: +I think good use-case is to create special directory to be used for +instantlauncher root. This special root directory can in turn contain +symlinks to various places user wants to visit often. Instantlauncher +will follow symlinks as if they were directories.
+ ++navigationRootPath: /home/svjatoslav/ ++