.Dd March 29, 2017 .Dt LUMINA-OPEN 1 .Os Lumina Desktop Environment .\"------------------------------------------------------------------- .Sh NAME .Nm lumina-open .Nd Application launcher for the Lumina Desktop Environment. .\"------------------------------------------------------------------- .Sh SYNOPSIS .Nm .Pp .Nm .Cm [-select | -action <ActionID>] <file path or URL> .Pp .Nm .Cm [-volumeup | -volumedown | -brightnessup | -brightnessdown | -autostart-apps | -terminal] .\"------------------------------------------------------------------- .Sh DESCRIPTION Given a file with an absolute pathway or URL, the .Nm utility finds the appropriate application which which to open the file. If the file is a *.desktop application shortcut, .Nm starts the application automatically. Using the appropriate flags allows .Nm to perform a few specific system operations. Here are the commands, flags, and descriptions of their functionality: .Pp .Bl -tag -width indent .It Ic lumina-open Displays the description and usage for lumina-open. .It Ic lumina-open [-select | -action <ActionID>] <file path or URL> Opens the file using the appropriate application. .It Fl select Optional flag. Bypasses any default application settings to display the application selector window. .It Fl action\ <ActionID> Optional flag. Runs the specified ActionID that is listed in a .desktop registration file rather than the main command. .It Ic lumina-open [-volumeup | -volumedown | -brightnessup | -brightnessdown | -autostart-apps | -terminal] .Pp This command is used to perform system operations, depending on the specific flags. .It Fl volumeup Increase system audio volume by 5%. .It Fl volumedown Decrease system audio volume by 5%. .It Fl brightnessup Increase screen brightness by 5%. .It Fl brightnessdown Decrease screen brightness by 5%. .It Fl autostart-apps Launches all applications registered with the XDG autostart application. Typically run by the desktop and not manually launched. .It Fl terminal Open the user's default terminal. .El .\"------------------------------------------------------------------- .Sh EXAMPLES .Bl -tag -width indent .It lumina-open -brightnessup Increase screen brightness. .Pp .It lumina-open sample.txt .Nm finds the default program for .txt files and opens sample.txt with the appropriate application. .It lumina-open ~/Documents .Nm launches the default file manager, pointed to the current user's Documents directory. .It lumina-open http://lumina-desktop.org Launches the default web browser pointed to the Lumina website. .El .\"------------------------------------------------------------------- .Sh FILES .Bl -tag -width indent .It Pa ${XDG_CONFIG_HOME}/mimeapps.list Default file that saves mimetype to application associations. .It Pa ${XDG_CONFIG_HOME}/${XDG_CURRENT_DESKTOP}-mimeapps.list Default file that saves mimetype to application associations for the current desktop session. This file is used before the generic associations file. .El .\"------------------------------------------------------------------- .Sh SEE ALSO .Xr XDG-OPEN(1) .\"------------------------------------------------------------------- .Sh REFERENCES For .desktop entry specifications and formatting, refer to these websites: .Bl -tag -width indent .Pp .Cm https://specifications.freedesktop.org/desktop-entry-spec/latest/ .Pp Specifications for .desktop files. .Pp .Cm https://specifications.freedesktop.org/mime-apps-spec/latest/ .Pp Details how default applications are registered. .Pp .Cm https://specifications.freedesktop.org/autostart-spec/latest/ .Pp Used in the -autostart-apps action. Determines which applications are automatically started. .Pp .El .\"------------------------------------------------------------------- .Sh AUTHOR .An Tim Moore .Aq timmoore88@gmail.com