Skip to main content

Hyprsimple plugin

The muslimtify-hyprsimple plugin puts Muslimtify on the Hyprsimple bar. The bar shows the next prayer and its time. Click it for a panel with today's prayer times, a countdown, and every Muslimtify setting.

Requirements​

  • Hyprsimple with the external plugin API 1, which is any version that ships the hyprsimple-plugin command.
  • Arch Linux, because the plugin manager installs Muslimtify from the AUR when it is missing.

You do not need to install Muslimtify first. The plugin declares the muslimtify AUR package as a dependency, and the manager installs it, registers the daemon and enables the plugin in one step. Hyprsimple also installs this plugin by default, so on a fresh Hyprsimple setup it is already on the bar.

The plugin reads your Muslimtify config and changes it only through the muslimtify CLI. Notifications still come from the Muslimtify daemon, so if they stop, check that it is running:

muslimtify daemon status

Install​

hyprsimple-plugin muslimtify-org/muslimtify-hyprsimple

A bare owner/repository or a GitHub HTTPS URL is treated as install, so this is the same as hyprsimple-plugin install https://github.com/muslimtify-org/muslimtify-hyprsimple.git. The code lands in ~/.local/share/hyprsimple-plugins/muslimtify, and the plugin is recorded in ~/.config/hyprsimple/plugins.json.

Installing runs muslimtify daemon install and then muslimtify daemon status. If either fails, the plugin is installed but left disabled, and the command says so. Fix the cause and run hyprsimple-plugin enable muslimtify.

The widget sits on the left of the bar. To move it, set placement for the muslimtify entry in ~/.config/hyprsimple/plugins.json to left, center or right, then restart the bar.

Bind a key​

The plugin binds no key of its own. Its panel alias is prayer, so you can open it from any Hyprsimple binding. Add a line to ~/.config/hypr/bindings/applications.lua:

hl.bind("SUPER + P", hl.dsp.exec_cmd(vars.barPanel .. "prayer"), { description = "Prayer Times (panel)" })

The same panel opens from a terminal or a script:

qs -p ~/.local/share/hyprsimple/default/quickshell ipc call bar toggle prayer

Manage​

hyprsimple-plugin list # installed plugins, with version and whether each is enabled
hyprsimple-plugin update muslimtify # update to the newest release
hyprsimple-plugin disable muslimtify # hide the widget and unregister the daemon
hyprsimple-plugin enable muslimtify # register the daemon and show the widget again
hyprsimple-plugin remove muslimtify # disable, then delete the plugin's code

enable runs muslimtify daemon install and checks muslimtify daemon status. If either fails the plugin stays disabled and enable can be run again. disable runs muslimtify daemon uninstall. Disabling or removing the plugin keeps your Muslimtify configuration and the installed package, so enable or a fresh install brings everything back as it was.

Using it​

On the bar​

The label is the next prayer as plain text, such as Asr 14:54. It is hidden until a schedule has been read.

ActionResult
Left-clickOpens or closes the panel
Right-clickSwitches between the prayer time and the countdown, such as Asr -01:55

Hovering shows the full line, for example Asr at 14:54, in 01:55. The label is highlighted when the next prayer is 15 minutes away or less.

Today​

The panel opens on today's schedule:

  • A card with the next prayer, its time and a countdown. After Isha it shows tomorrow's Fajr, marked tomorrow.
  • The five prayers with their times.
  • On each prayer row, a bell toggles its notification and a speaker toggles its adhan.
  • Links to the Muslimtify GitHub repository and this website.

If the schedule cannot be read, the panel header shows the error, keeps the last usable schedule on screen, and retries on its own.

Settings​

Open settings with the gear button or the s key. The sections, top to bottom:

SectionSettings
Time format12-hour or 24-hour clock
LocationWhether the location is auto-detected or set manually, a Detect from IP button, latitude, longitude, timezone, city, country, refresh interval, and a Use GPS switch
CalculationMethod and madzhab
One section per prayerReminder minutes and offset for Fajr, Dhuhr, Asr, Maghrib and Isha
NotificationsUrgency and sound

Changes save right away through the muslimtify CLI. Toggles and dropdowns apply when you change them, and text fields apply when you press Enter or move to another field. A value Muslimtify rejects is shown as an error under the field and is not saved.

Changing the coordinates switches the location to manual, clears the city and country, and sets the timezone from the new coordinates. Set the city and country again afterwards if you want them.

See Configuration for what each setting does.

Keys​

KeyAction
sOpens settings, or closes them
rRefreshes the prayer times
EscLeaves settings, or closes the panel

Keys typed into a text field go to the field, not to the panel.

Troubleshooting​

The panel says muslimtify was not found​

The plugin could not run the muslimtify command. Install the package and make sure command -v muslimtify prints a path, then restart the bar. If you removed the package yourself, hyprsimple-plugin enable muslimtify installs it again.

The widget does not appear​

Check that the plugin is installed and enabled:

hyprsimple-plugin list

If it is listed as disabled, run hyprsimple-plugin enable muslimtify and read its output: it fails when muslimtify daemon install or muslimtify daemon status fails, and says which. The widget is also hidden until the first schedule has been read, so give it a moment after enabling.

update refuses to run​

hyprsimple-plugin: refusing dirty plugin update

The plugin directory has local edits. The manager updates with git and will not overwrite your changes. Either commit or discard them in ~/.local/share/hyprsimple-plugins/muslimtify, or remove and reinstall the plugin.

For anything else, open an issue on muslimtify-hyprsimple.