|Calvin Kent McNabb c28a6515db||5 months ago|
|Arch_Builds||5 months ago|
|DEB_Builds||5 months ago|
|icons||5 months ago|
|preview_images||6 months ago|
|.gitignore||6 months ago|
|COPYING||6 months ago|
|LICENSE||6 months ago|
|README||5 months ago|
|README.md||5 months ago|
|jwmkit_about.py||6 months ago|
|jwmkit_calendar||6 months ago|
|jwmkit_config||6 months ago|
|jwmkit_groups||5 months ago|
|jwmkit_icons||6 months ago|
|jwmkit_keys||5 months ago|
|jwmkit_logout||5 months ago|
|jwmkit_menus||6 months ago|
|jwmkit_popmixer||6 months ago|
|jwmkit_popmuter||6 months ago|
|jwmkit_popvolume||6 months ago|
|jwmkit_startups||6 months ago|
|jwmkit_trays||6 months ago|
|jwmkit_video_wrap||6 months ago|
|jwmkit_wallpaper||6 months ago|
JWM Kit is Free Open Source Software. See License .
June 03, 2020, New addition to the kit: JWM Kit Groups Editor
As they say a picture is worth a thousand words. Here are some pictures with the details highlighted.
note: small changes have been made to the appearance since theses screenshots were made
Finding the perfect icon and adding it’s path to JWM’s Icon XML file.
you can find more preview images in the preview_images directory
This README file is not an instruction manual, or FAQ. It’s purpose is to disclose technical information about JWM Kit. Including but not limited to:
*This list of dependencies uses Debian based packages name. The equivalent package may have a different name on non-Debian based distributions.
**GTK3 Documentation recommends python3-gi-cairo, but none of JWM Kit’s code references it directly. Everything seems to work fine without it, The requires disk space of the package is only 482 kb . So it wouldn’t hurt much to include it.
These items and the dependencies should be all you need to implement JWM Kit. Recommended or required install path is listed as well.
App files list: jwmkit_calendar, jwmkit_config, jwmkit_icons, jwmkit_keys, jwmkit_logout, jwmkit_menus, jwmkit_startups,
jwmkit_trays, jwmkit_wallpaper, jwmkit_popmixer, jwmkit_popmuter, jwmkit_popvolume, jwmkit_about.py , jwmkit_video_wrap
Name: JWM Kit Calendar
Usage: Simple pop up calendar. Bind to a mouse click on the clock for behavior similar to other desktops.
Name: JWM Kit Config Editor
Usage: configure the paths to the JWM XML files you wish to include in the .jwmrc file and the JWM Kit Settings file. For example: trays, menus, startups, etc. If necessary you can also create an empty valid JWM XML file for entries
Note: improper configurations with this tool could require you to repair your system from the commandline without a graphical interface. As a precaution all populated entries are locked by default. To edit an entry you must unlock it with the adjacent check button.
Name: JWM Kit Groups Editor
Usage: Create and edit groups to specify options which apply to a group of programs by their name and/or class
Name: JWM Kit Icon Paths
Usage: Tell JWM where to find icons. Add as many paths as needed, and arrange the order for search priority. The included search tool will help your find icons, and you can preview the directories of the search results with the view button before adding them to the list.
Name: JWM Kit Keys
Usage: Configure key bindings. example: Alt F2 for the run command
Name: JWM Kit Logout
Usage: A simple logout menu. Options are Cancel, Logout, Reboot, and Shutdown.
Name: JWM Kit Menu Editor
Usage: Configure the appearance and behavior of JWM menus. Add, remove, and edit apps, menus/sub-menus, specify icons, etc
Name: JWM Kit Pop Volume
Filenames: jwmkit_popvolume, jwmkit_popmixer, and jwmkit_popmuter
Usage: Assign volume notification to a tray icon or key shortcuts. Choice of horizontal or vertical slider or simple display percent of max volume. (Un)mute displays the appropriate icon. To be clear it does not run in the background. Mouse movement or key presses triggers it to run and it automatically closes in seconds.
Syntax: For info on this program’s syntax enter this command in the terminal: jwmkit_popvolume help
Note: Total of 3 file. The popmixer, and popmuter should not be called directly. They are used by JWM Kit Popvolume
Name: JWM Kit Startups
Usage: Configure commands (scripts, apps, etc) to run when JWM starts, restarts and/or shutdown. Features a display button to simplify adding your current display configuration to startup.
Name: JWM Kit Tray Editor
Usage: Configure the appearance and behavior of JWM trays as well as the items contained in the tray. Add, remove, & edit all possible items types, icons, etc and configure their behavior.
Name: JWM Kit Wallpaper
Usage: Browse, select, and set the wallpaper images as stretch, scale, or titled. For a more minimal appearance set the desktop as a solid color or gradient
Name: JWM Kit Video Wrapper
Usage: JWM Kit Video Wrapper will start the tool of your choice for configuring your screen settings / layout. Once complete JWM Kit Video Wrapper will ask you if you would like to save your new Screen settings as a JWM StartupCommand. This prevents you from having to set your screen every time you login.
Name: JWM Kit About
Purpose: Simple About Dialog window with license info
Note: This file is a dependency for the other files in this kit.
JWM Kit Tray and Menu Editors uses “xterm” as the default terminal for terminal apps. You can specify the terminal when starting the app. For example to use xfce4-terminal start the tray and menu editor with these commands:
You can specify how JWM Kit Logout peforms reboot and shutdown. Default is dbus and ConsoleKit.
JWM Kit Logout flag options:
No flag ----------------used dbus with ConsoleKit (default)
sudo -------------------use reboot and poweroff with sudo
gksu -------------------use reboot and poweroff with gksu
gksudo ----------------use reboot and poweroff with gksudo
su-to-root -X -c ------use reboot and poweroff with su-to-root -X -c
x ------------------------use reboot and poweroff with su-to-root -X -c
su-to-root -c ----------use reboot and poweroff with su-to-root -c
nox ---------------------use reboot and poweroff with su-to-root -c
any other flag --------use reboot and poweroff without sudo
TODO: Add systemd option
jwmkit_logout -----------will use dbus with ConsoleKit
jwmkit_logout nox ------will use su-to-root -c /sbin/poweroff for shutdown
jwmkit_logout nosu ----will use /sbin/poweroff for shutdown
Specifying Root privilege
Currently the Tray and Menu editor have no option to assist in creating item with root privilege. You must manually edit the exec: command to use a root method avalible on your system. Also pay attention when selecting apps from the drop down combo that the orginal .desktop file does not use a root method not compatible with your system. For example if the app uses gksudo, but you do not have gksudo install you may wish to change the gksudo part to su-to-root
JWM Kit needs these file to operate correctly.
~/.config/jwmkit/LastWallDir --*works fine without it and will be created when needed
~/.config/jwmkit/settings -------*part of JWM Kit will not function correctly without it. Can be created with JWM Kit Config Editor
/usr/share/pixmaps/jwmkit/ --*work without them but will change the appearance
Detail info of the file: ~/.config/jwmkit/LastWallDir
JWM Kit Wallpaper creates this file. It’s Just a single line with the path to the last directory used by the JWM Kit Wallpaper
Detail info of the file: ~/.config/jwmkit/settings
This file can be created/edited via JWM Kit Config Editor but can easily be recreated/edited manually. Just compare it with ~/.jwmrc file for basic understanding.
This file includes all items referenced in the .jwmrc file with the <Include> tag, but uses key words to clearly define the purpose of each entry to JWMkit.
Syntax of the file ~/.config/jwmkit/settings:
|XML Entry Type||Rule||Key||Recommended||Example|
|Tray||must start with||tray||tray-description||tray-top|
|Menu||must start with||menu||menu-description||menu-main|
|Startup||must start with||start||startups||startups|
|Icon Paths||must start with||icons||icons||icons|
|Preferences||must be exactly||preferences||preferences||preferences|
|Keys||must be exactly||keys||keys||keys|
|Groups||must start with||group||groups||groups|
|Theme||must start with||theme||theme-description||theme-default|
The settings file may also includes the path to a theme directory (themes-dir). This can be ignored for now as it is for future use and is currently not implemented.
Menu Editor: When adding the first and only item to an empty menu the drop down combos are inactive.
Workaround: Simply add a 2nd item to activate the combo items.
JWM Kit Config Editor somewhat checks that selected files are valid for the intended purpose. This is to ensure proper functionality of both JWM and JWM Kit. This check is part of the file selection dialog. You can bypass this check by manually entering the path into the form entry and not using the file selection dialog.
Warning. Bypassing the check may cause improper operation of JWM and/or JWM Kit