1 #+TITLE: Instantlauncher - navigate to your files and programs quickly!
3 * (document settings) :noexport:
4 ** use dark style for TWBS-HTML exporter
5 #+HTML_HEAD: <link href="https://bootswatch.com/3/darkly/bootstrap.min.css" rel="stylesheet">
6 #+HTML_HEAD: <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
7 #+HTML_HEAD: <script src="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.5/js/bootstrap.min.js"></script>
8 #+HTML_HEAD: <style type="text/css">
9 #+HTML_HEAD: footer {background-color: #111 !important;}
10 #+HTML_HEAD: pre {background-color: #111; color: #ccc;}
14 - This program is free software: you can redistribute it and/or modify
15 it under the terms of the [[https://www.gnu.org/licenses/lgpl.html][GNU Lesser General Public License]] as
16 published by the Free Software Foundation, either version 3 of the
17 License, or (at your option) any later version.
21 - Homepage: http://svjatoslav.eu
22 - Email: mailto://svjatoslav@svjatoslav.eu
24 - [[http://www.svjatoslav.eu/projects/][Other software projects hosted at svjatoslav.eu]]
27 - [[http://www2.svjatoslav.eu/gitweb/?p=instantlauncher.git;a=snapshot;h=HEAD;sf=tgz][Download latest snapshot in TAR GZ format]]
29 - [[http://www2.svjatoslav.eu/gitweb/?p=instantlauncher.git;a=summary][Browse Git repository online]]
31 - Clone Git repository using command:
32 : git clone http://www2.svjatoslav.eu/git/instantlauncher.git
35 Quick filesystem based document/application launcher. It starts by
36 showing content of [[id:5ced6bf5-165a-49a0-8de4-3755d810d987][predefined directory]]. Sub directories can be chosen
37 by simply moving mouse pointer over corresponding directory.
39 [[file:screenshot.png]]
41 Files types are color-coded.
44 Simply hovering mouse pointer over directory expands its contents in
45 the next right column.
48 + Executable file (red):
50 + Run executable file.
52 + Toggle executable state.
54 + Non-executable file (green):
56 + Open file using corresponding application.
58 + Toggle executable state.
60 + Directory/symlink (blue):
62 + Open directory using configured filesystem browser.
64 + Open directory using configured text based terminal emulator.
67 When instantlauncher starts, it looks for configuration file under
70 If file is not found, it creates new default configuration file in
74 directoryOpenCommand: nautilus -w {file}
75 directoryTerminalOpenCommand: gnome-terminal --working-directory={file}
79 - command: emacs {file}
91 - command: emacs {file}
93 navigationRootPath: /home/svjatoslav/
96 ** directoryOpenCommand
97 Command to use when opening directory.
99 By default instantlauncher assumes that Gnome desktop environment is
100 installed and uses Nautilus file manager:
101 : directoryOpenCommand: nautilus -w {file}
102 ** directoryTerminalOpenCommand
103 Command to use when opening directory in text terminal based console.
105 By default instantlauncher assumes that Gnome desktop environment is
106 installed and uses Gnome Terminal:
108 : directoryTerminalOpenCommand: gnome-terminal --working-directory={file}
110 Allows to map file name/extension using regular expression pattern
111 matching to corresponding application.
115 - command: vlc {file}
120 - command :: Command to execute to open given file. Special variable
121 {file} will point to user chosen file using absolute file
124 - fileRegex :: Regular expression that must match the file.
125 ** navigationRootPath
127 :ID: 5ced6bf5-165a-49a0-8de4-3755d810d987
129 Root directory from where to start navigation.
131 This parameter is user specific! In my case instantlauncher by default
132 pointed this to my home directory. But it can be any directory user
135 I think good use-case is to create special directory to be used for
136 instantlauncher root. This special root directory can in turn contain
137 symlinks to various places user wants to visit often. Instantlauncher
138 will follow symlinks as if they were directories.
140 : navigationRootPath: /home/svjatoslav/