Skip to main content

universal file launcher for terminal

Project description


universal file launcher for terminal

Launch any file in terminal with one unique command. flauncher works as a command router and launches the entered files with the according application regarding your preferences settings.

flauncher deals with audio, image, libreoffice-writer (odt), libreoffice-calc (ods), pdf, rar, tar, tar.gz, tar.xz, tar.bz2, text, tgz, zip and video files.


with pip:
sudo pip3 install flauncher

with yay:
yay -a flauncher

with yaourt:
yaourt -a flauncher


python >= 3


flauncher [FILE_PATH_01 FILE_PATH_02 ...]
         -h, --help        show this help message and exit


the settings defining the command to be run for any extension type are located in the ~/.config/flauncher/launchers.json json file.

if this file doesn't exist, copy the default one located in ~/.config/flauncher/launchers.json and configure it as you wish.

  "audio": {
    "type": "playlist",
    "exts": ["mp3", "wav", "m4a", "aac", "mp1", "mp2", "flac", "aa", "aax", "act", "aiff", "amr", "ape", "au", "awb", "dct", "dss", "dvf", "gsm", "iklax", "ivs", "m4b", "m4p", "mmf", "mpc", "msv", "nmf", "nsf", "oga", "mogg", "opus", "ra", "raw", "sin", "tta", "vox", "wma", "wv", "8svx"],
    "cmd": "mpv -fs --loop-playlist -script-opts=osc-hidetimeout=6000 --player-operation-mode=pseudo-gui"
  "image": {
    "type": "playlist",
    "exts": ["jpg", "jpeg", "png", "tif", "gif", "bmp", "pjpeg", "jfif", "exif", "tiff", "png", "ppm", "pgm", "pbm", "pnm", "webp", "hdr", "heif", "bat", "bpg"],
    "cmd": "feh -d -Y -F"
  "libreoffice_writer": {
    "type": "lonely",
    "exts": ["odt"],
    "cmd": "libreoffice --writer"
  "libreoffice_calc": {
    "type": "lonely",
    "exts": ["ods"],
    "cmd": "libreoffice --calc"
  "pdf": {
    "type": "lonely",
    "exts": ["pdf"],
    "cmd": "evince -f"
  "rar": {
    "type": "archive_a",
    "exts": ["rar"],
    "cmd": "unrar x"
  "tar": {
    "type": "archive_a",
    "exts": ["tar"],
    "cmd": "tar -xvf"
  "tar_gz": {
    "type": "archive_a",
    "exts": ["tar.gz"],
    "cmd": "tar -zxvf"
  "tar_xz": {
    "type": "archive_b",
    "exts": ["tar.xz"],
    "cmd": "tar --directory FOLDER_PATH -xJf ARCHIVE_PATH"
  "tar_bz2": {
    "type": "archive_a",
    "exts": ["tar.bz2"],
    "cmd": "tar jxvf"
  "text": {
    "type": "lonely",
    "exts": ["text", "txt", "conf", "sh", "py", "note", "log", "c", "h", "js", "tmp", "json", "csv", "java", "xml", "tex", "js"],
    "cmd": "atom"
  "tgz": {
    "type": "archive_a",
    "exts": ["tgz"],
    "cmd": "tar -xvzf"
  "video": {
    "type": "playlist",
    "exts": ["avi", "mpeg", "mp4", "ogg", "quicktime", "webm", "mp2t", "flv", "mov", "webm", "mkv", "mts", "vob", "ogv", "drc", "gif", "gifv", "mng", "mts", "m2ts", "mwv", "yuv", "rm", "rmvb", "asf", "amv", "m4v", "mpg", "mpe", "mpv", "m2v", "svi", "3gp", "3g2", "mxf", "roq", "nsv", "f4v", "f4p", "f4a", "f4b"],
    "cmd": "mpv -fs --loop-playlist -script-opts=osc-hidetimeout=2000"
  "zip": {
    "type": "archive_b",
    "exts": ["zip"],
    "cmd": "unzip -d FOLDER_PATH ARCHIVE_PATH"

by default any audio and video files are launched with mpv, any image with feh, any pdf with evince and any text with the atom editor. But feel free to customize it with your application launcher preferences.


for help:

flauncher -h
flauncher --help

launch a pdf, a zip, a tar.gz and a mp3:

flauncher titi.pdf toto/ toto/tutu.tar.gz toto/tata/tutu.mp3


use the o command to open any file:

alias o='flauncher'

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for flauncher, version 1.1.7
Filename, size & hash File type Python version Upload date
flauncher-1.1.7.tar.gz (6.5 kB) View hashes Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page