apparat_launcher Download - apparat_launcher Source code download

apparat_launcher

Other source code

1.0.0

Download

apparat_launcher

Important notice

This program is currently in a very early development state.

Description

apparat_launcher is an application launcher for linux. It is developed and tested for Gnome Desktop environments.

Screenshots

Launcher UI

Tray-Icon (Gnome)

Installation

There is no installation routine so far.

Requirements

Python modules

difflib
fnmatch
os
platform
psutil
subprocess
sys
webbrowser
wx
xdg
xdg.IconTheme

Linux packages

The following packages are needed:

gnome-screensaver-command
gnome-session-quit
systemctl
xdg-open
xdotool

Usage

Navigate to apparat_launcher
Execute: ./apparat_launcher.py

Parameter

The following command line parameters are available:

Parameter	Alias	Function
`-d`	`--debug`	Show debug output
`-h`	`--help`	Show help
`-v`	`--version`	Show version

Debug output

Hotkey

If you want to use a global/system-wide hotkey to trigger apparat_launcher (starting, focusing and minimizing) consider using the script hotkeyHelperForApparatLauncher.sh. Simply define a system-wide hotkey which triggers hotkeyHelperForApparatLauncher.sh.

Hotkey definition in Gnome

Open the Activities overview and start typing Keyboard.
Click on Keyboard to open the panel.
Select the Shortcuts tab.
Select a category in the left pane, and the row for the desired action (launching hotkeyHelperForApparatLauncher.sh) on the right. The current shortcut definition will change to New accelerator…
Hold down the desired key combination, or press Backspace to clear.

Plugins

Core

Core plugin (can not be disabled)

Trigger	Alias	Parameter	Function
`!help`			Open apparat_launcher online documentation
`!preferences`	`!prefs`		Open apparat_launcher preferences

Kill

Optional plugin to kill graphical applications using xkill

Trigger	Alias	Parameter	Function
`!xkill`	`!kill`		Starts xkill

Misc

Optional plugin

Trigger	Alias	Parameter	Function
`!open`		path	Open file or folder using default application

Nautilus

Optional plugin which offers quick access to some locations in nautilus

Trigger	Alias	Parameter	Function
`!goto`		path	Open directory in nautilus
`!network`	`!net`		Show network devices in nautilus
`!recent`			Show recent files in nautilus
`!trash`			Show trash in nautilus

Password Generator

Optional plugin which offers a simple password generator

Trigger	Alias	Parameter	Function
`!pw`	`!password`		A simple password generator

Screenshot

Optional plugin which offers screenshot functionality

Trigger	Alias	Parameter	Function
`!ss`			Selective screenshot (window or area)
`!fs`			Full screenshot

Search-Internet

Optional plugin which offers easy access to some popular web-services

Trigger	Parameter	Function
`!am`	searchstring	Amazon
`!au`	searchstring	Ask Ubuntu
`!bc`	searchstring	BandCamp
`!dd`	searchstring	DuckDuckGo
`!fb`	searchstring	FaceBook
`!fe`	searchstring	Fefe
`!fl`	searchstring	Flickr
`!gh`	searchstring	GitHub
`!gi`	searchstring	Google Images
`!gk`	searchstring	Google Keep/Notes
`!gm`	searchstring	Google Maps
`!gn`	searchstring	Google News
`!gs`	searchstring	Google Search
`!la`	searchstring	LastFM
`!re`	searchstring	Reddit
`!sc`	searchstring	SoundCloud
`!se`	searchstring	Stack-Exchange
`!so`	searchstring	Stack-Overflow
`!tu`	searchstring	Tumblr
`!tw`	searchstring	Twitter
`!vi`	searchstring	Vimeo
`!wi`	searchstring	Wikipedia
`!yt`	searchstring	YouTube

Search-Local

Optional plugin which offers a file search for $HOME

Trigger	Alias	Parameter	Function
`?`		searchstring	Filesearch for home directory

Session

Optional plugin which offers access to some session commands

Trigger	Alias	Function
`!hibernate`	`!sleep`	hibernate the machine
`!lock`		locks the current session
`!logout`		logout from current session
`!reboot`	`!restart`	reboot the machine
`!shutdown`	`!halt`	shutdown the machine
`!screensaver`	`!saver`	start screensaver

Shell

Optional plugin which allows running terminal commands from within the launcher

Trigger	Alias	Parameter	Function
`!sh`		path	Run terminal commands in new window

Changelog

The file CHANGELOG.md provides an overview of the major changes of this project; for a more detailed look at changes to the code, view individual commits.