pragha(1)

💖 pragha — the manual page, but make it cute 💖

okay so bestie, you're looking at the pragha(1) manual page and honestly? you've come to the right place. grab a boba, sit down, we're doing this together. 🧋✨

---

🌸 NAME 🌸

pragha — a lightweight music player, forked of Consonance Music Manager. yes, it has lore. every icon does. 👑

---

🎀 SYNTAX 🎀

the way you actually run it:

pragha [OPTION...] [FILE1 [FILE2...]]

so like… options first, then as many files as your little heart desires. periodt. 💅

---

🦋 DESCRIPTION 🦋

pragha is a lightweight music player that aims to be fast, bloat-free, and light on memory consumption. like, it's not trying to be your entire personality, it just wants to play your songs and not eat your RAM. main character energy but make it humble. 😌

It is written completely in C and GTK+. pure. classic. no notes.

Some of the features are:

• Library management using sqlite3
• Multiple views
• OSD support
• asf, ape, flac, mp3, mp4, ogg, wav, wma, and CDDA support

pragha is released under the GNU General Public Licence version 3 (GPLv3). slay, legally. ⚖️✨

---

✨ OPTIONS ✨

every single flag, bestie. no skips, no cuts. 🫶

• -?, --help — outputs help information and then exits. the classic "wait what do I do" move. 🙈
• --help-all — outputs all help options and exits. the deluxe version.
• --help-gtk — outputs the GTK+ Options and exits. for the GUI girlies. 🎀
• -v, --version — outputs version information and exits.
• -e, --debug — enable Debug. Levels: 1,2,3,4. pick your chaos level. 💀
• -l, --log-file — log Debug to a file. receipts, but make them technical. 🧾
• -p, --play — start playing. press play, literally. 🔥
• -s, --stop — stop playing. the sad one. 😭
• -t, --pause — Play/Pause/Resume the current song. one flag, three moods.
• -r, --prev — play the previous song in the playlist. go back bestie.
• -n, --next — play the next song in the playlist. skip, skip, skip. ⏭️
• -f, --shuffle — toggle shuffle mode. chaos mode: activated. 🌀
• -u, --repeat — toggle repeat mode. for when one song is your whole personality.
• -i, --inc_vol — increase the volume by 1. turn it UP. 🔊
• -d, --dec_vol — decrease the volume by 1. turn it down, respectfully.
• -o, --show_osd — show OSD notification (a popup window with info about the current song). a lil pop-up that says who's singing. 💬
• -x, --toggle_view — toggle player visibility. now you see it, now you don't. 🙈
• -c, --current_state — get current player state. vibe check, but for the player. 🫧
• -a, --audio_backend — Audio backend (valid options: alsa/oss)
• -g, --audio_device — Audio Device (For ALSA: hw:0,0 etc.., For OSS: /dev/dsp etc..)
• -m, --audio_mixer — Mixer Element (For ALSA: Master, PCM, etc.., For OSS: /dev/mixer, etc...)
• --display=DISPLAY — set the X display to use.

---

🌈 USAGE 🌈

1. Add a library location in menu Edit - Preferences.
2. Rescan Library from menu Tools.
3. Start using. :-)

like that's it. three steps. you got this. 🫶✨

---

💜 FILES 💜

• $HOME/.config/pragha/pragha.db — Library database (in sqlite3 format)
• $HOME/.config/pragha/config — personal settings (use the GUI interface to change them, Edit - Preferences)
• $HOME/.cache/pragha-album-art — Basic cache for downloaded cover art saved as artist - album.jpeg

ngl bestie, don't hand-edit the config file. the manpage literally says use the GUI. it's giving "trust the process". 💅

---

👑 AUTHORS 👑

• Pragha was originally a fork of Consonance written by Sujith <m.sujith@gmail.com>
• At the moment developed by Matias De lellis. <mati86dl@gmail.com>
• Man page written by Martin Zelaia <martintxo@sindominio.net>

give them their flowers. they earned them. 💐

---

🍓 SEE ALSO 🍓

• http://pragha-music-player.github.io
• http://sites.google.com/site/consonancemanager

iykyk. go check them out. 🔗

---

and that's the whole page, bestie!! 🎉 this lovely little doc came to you from Matias De lellis, version 1.3.3, filed under pragha(1) — so you know exactly who to thank and which version you're reading. now go play some music. you've earned it. 🎧💖🦋

---