Skip to content

Latest commit

 

History

History
168 lines (121 loc) · 6.17 KB

README.md.in

File metadata and controls

168 lines (121 loc) · 6.17 KB
Raw

@PACKAGE@

Package @PACKAGE@-@VERSION@ was released under GPLv3 license @DATE@.

This is a "C"-language program that can be used to launch XDG desktop applications with full startup notification and window manager assistance from the command line. The command is able to launch desktop applications, autostart entries and xsession entries. It is useful when generating applications root menus for light-weight window managers that do not provide startup notification for applications launched using the keyboard or root menu.

The source for @PACKAGE@ is hosted on GitHub.

Release

This is the @PACKAGE@-@VERSION@ package, released @DATE@. This release, and the latest version, can be obtained from GitHub, using a command such as:

$> git clone https://github.com/bbidulock/@PACKAGE@.git

Please see the RELEASE and NEWS files for release notes and history of user visible changes for the current version, and the ChangeLog file for a more detailed history of implementation changes. The TODO file lists features not yet implemented and other outstanding items.

Please see the INSTALL file for installation instructions.

When working from git(1), please use this file. An abbreviated installation procedure that works for most applications appears below.

This release is published under GPLv3. Please see the license in the file COPYING.

Quick Start

The quickest and easiest way to get @PACKAGE@ up and running is to run the following commands:

$> git clone https://github.com/bbidulock/@PACKAGE@.git
$> cd @PACKAGE@
$> ./autogen.sh
$> ./configure
$> make
$> make DESTDIR="$pkgdir" install

This will configure, compile and install @PACKAGE@ the quickest. For those who like to spend the extra 15 seconds reading ./configure --help, some compile time options can be turned on and off before the build.

For general information on GNU's ./configure, see the file INSTALL.

Dependencies

To build and install this package, the libxrandr, libxinerama and glib2 packages should be installed first. To run the dmenu_launch script in the package requires the dmenu package to be installed.

Running

Read the manual page after installation:

$> man @PACKAGE@

Features

The following programs are included in @PACKAGE@:

  • xdg-launch(1) -- This is the primary program.

  • dmenu_launch(1) -- This is a little script that uses xdg-launch(1) and dmenu(1) to provide an application menu.

  • xdg-autostart(1) -- This is a little script that invokes xdg-launch(1) as a launcher for auto-start programs instead of applications.

  • xdg-xsession(1) -- This is a little script that invokes xdg-launch(1) as a launcher for X Sessions programs (window managers) instead of applications.

  • xdg-session(1) -- This is a little script that invokes xdg-launch(1) as a launcher for X Sessions programs (window managers) instead of applications a simple session and full auto-start procedure.

  • xdg-entry(1) -- This is a little script that invokes xdg-launch(1)` with the --info option and lists which information would be used for startup notification and launching of the resulting application.

  • xdg-toolwait(1) -- This is a little script that invokes xdg-launch(1) with the --toolwait option.

  • xdg-which(1), xdg-whereis(1) -- Two little programs what parallel which(1) and whereis(1) for desktop entry files instead of binaries.

  • xdg-assist(1) -- A program to monitor startup notification and provide notification as programs start up and performs startup notification completion of applications that do not complete. It also assists window managers with supporting startup notification and other EWMH/NetWM features.

  • xdg-list(1) -- lists desktop entry files.

  • xdg-types(1) -- shows the content types provided by a desktop application.

Also provided (when glib2 is available) are some little tools for the XDG desktop:

  • xdg-find(1) -- finds desktop entry files based on a number of search criteria.

  • xdg-prefs(1) -- locates or sets preferred applications by category or mime type.

Issues

Report issues on GitHub here.