dbus-app-launcher: Simple app launcher for D-Bus

[ mit, program, system ] [ Propose Tags ]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 0.1.0.0
Change log CHANGELOG.md
Dependencies base (>=4.7 && <5), containers (>=0.6 && <0.7), dbus (>=1.3 && <1.4), extra (>=1.7 && <1.8), unix (>=2.8 && <2.9) [details]
License MIT
Copyright 2024 Daniël van de Giessen
Author Daniël van de Giessen
Maintainer daniel@dvdgiessen.nl
Category System
Home page https://github.com/DvdGiessen/dbus-app-launcher#readme
Bug tracker https://github.com/DvdGiessen/dbus-app-launcher/issues
Source repo head: git clone https://github.com/DvdGiessen/dbus-app-launcher
Uploaded by DvdGiessen at 2024-03-24T13:12:36Z
Distributions NixOS:0.1.0.0
Executables dbus-app-launcher
Downloads 101 total (20 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs not available [build log]
Last success reported on 2024-03-24 [all 1 reports]

Readme for dbus-app-launcher-0.1.0.0

[back to package description]

dbus-app-launcher

A simple service that allows executing a program via D-Bus.

Note: Allowing D-Bus clients to execute arbitrary programs may pose a security risk. Use carefully.

Installation

To build the code, you will need Haskell and the stack command line utility. Get it here.

To build and install, run stack install. This will build the code and copy the executable to ~/.local/bin.

Next, set up a D-Bus service description that will automatically launch the new service whenever it is accessed:

/usr/share/dbus-1/services/nl.dvdgiessen.dbusapplauncher.service

[D-BUS Service]
Name=nl.dvdgiessen.dbusapplauncher
Exec=/home/USERNAME/.local/bin/dbus-app-launcher

Using the service

The service currently exports one interface, Exec. Calling any of the methods of this interface will start the program using the exec() syscall.

  • Service name: nl.dvdgiessen.dbusapplauncher
  • Object path: /nl/dvdgiessen/DBusAppLauncher
  • Interface: nl.dvdgiessen.dbusapplauncher.Exec
  • Methods:
    • Cmd(String cmd)
    • CmdArgs(String cmd, List<String> args)
    • CmdArgsEnv(String cmd, List<String> args, Map<String,String> env)

Issues and contributing

This is my first Haskell program, so there's probably plenty that could be improved upon. Feel free to fork it or open pull requests if you find a bug.

I might add more functionality in the future, for example for running programs and returning their exit code and stdout/stderr output. Currently my own use case for this program is for starting applications from KWin scripts (see kwin-toggleterminal if you're interested in that sort of thing), so adding more functionality probably won't be a priority until I have a need for it myself.

License

dbus-app-launcher is freely distributable under the terms of the MIT license.