Skip to content

Latest commit

 

History

History
102 lines (59 loc) · 4.48 KB

README.md

File metadata and controls

102 lines (59 loc) · 4.48 KB
Raw

Bus Icondj-feet

A cross-platform, JavaFX based clone of D-Feet, the D-Bus debugger provided by GNOME on Linux. It makes use of dbus-java, allowing you to debug your D-Bus application on any major desktop operating system.

Screenshot

Installation

Installers are provided for Linux, Windows and Mac OS. Download and run the GUI installers appropriate for your desktop.

Run From Source

To run from source, you will need at least version 3.8.3 of Apache Maven and a Java 17 development kit. I recommended downloading from Adoptium.

Simply run the following from the directory you clone to.

mvn javafx:run

Usage

What is available when you start the application will depend on the operating system you are on.

  • On any operating system, if you have installed the provided default dbus-java-daemon, it will also be shown.

  • Linux, you will see the System Bus, and the Session Bus by default.

  • If there are no default buses available, you will be immediately prompted for a bus address.

Other features include :-

  • Export existing DBus services as Java code (uses dbus-java's code generator)

  • Filter bus names by typing in the search box at the top-left of the user interface.

  • Select a bus in the left hand pane to view the available objects exported on that base.

  • Expand the tree nodes on the right to view Methods, Signals and Properties.

  • Double-click on a Method to execute it. The Method Input box accepts multiple comma separated parameters, you must supply all arguments a Method expects. Arguments are parsed using the Spring Expression Language. In practice, format arguments similiarly to you would using Java.

    Execute

  • Double-click on a Property to view it's current value. Values cannot currently be set.

Other Tools Installed

With the installers, also included are easy launchers for all of the dbus-java-utils tools.

  • dbus-java-daemon and dbus-java-daemonc. A replacement daemon you can use as a broker for operating systems that don't already have one. The former is installed as a service, and the latter as a command line tool you can just run when needed.
  • dbus-java-list. Just list all exported names.
  • dbus-java-caller. Invoke dbus methods.
  • dbus-java-create-interface. Geneate a Java interface from exported objects. DEPRECATED
  • dbus-java-interface-code-generator. Geneate a Java interface from exported objects.
  • dbus-java-viewer. Simple Swing UI based viewer.
  • dbus-java-type-string-to-java. Convert a DBus type string to Java.

Changes

1.1.0

  • Use (in development) dbus-java-5.0.0.
  • Now uses JPMS
  • Improvements to export. Option to use @DBusBoundProperty, Disable Filter and set alternative package name (now in upstream)
  • Now uses JMetro as skin. Looks more at home on Windows.
  • Several fixes for method executing, now supports new variant(<val>[,'<sig>']). See #2

1.1.0

  • Use official release of dbus-java-4.0.0.

1.0.2

  • Windows dj-feet not automatically loading dbus-java-daemon if it is installed.
  • Re-install may fail on Windows due to JRE file being in use.
  • Better internal monitoring of bus events.

1.0.1

  • Windows had incorrect classpath for dj-feet.exe.

1.0.0

  • Initial release

Development

Find the source and submit pull requests at the GitHub project page, you know the drill.

License

dj-feet is made available under GPL version 3. Other components under their respective licenses.

Attribution

Bus Icon made by Royyan Wijaya from www.flaticon.com