QUVIRC(5)

✨ QUVIRC ✨

okay bestie so this is the manual page for quvirc from the quvi manual, section 5 of the manual pages 💖 — and like, it's the simple configuration file for the quvi program. that's the whole vibe. the NAME is literally just quvirc and its one job is being the config file. iconic.

---

🌸 DESCRIPTION 🌸

so a quvi config file is basically groups of key-value pairs, lowkey like those .ini-style configuration files you've definitely seen before. quvi uses GLib to parse it, and GLib calls these files key files — not because it's a good name, but because they couldn't think of a better one 😭. we love a "for lack of a better name" moment.

the lines that start with a # are comments. you can annotate your config file with that character, no cap. all text after the comment character to the end of the line is ignored — so go off, write your little diary entries in there, nobody's reading them 🫶.

now, GKeyFile has some limitations that you genuinely need to consider when you use a configuration file to configure quvi. let's get into it:

💅 Multiple keys

each group in each configuration file may contain the same key multiple times, but heads up — the last key value replaces the previously defined value. so if you're out here defining the same key three times thinking you're being thorough, the earlier ones are just gone. periodt.

💅 Multiple groups

configuration files may contain multiple groups with the same file, they are however, merged together. so they're not fighting, they're collaborating 💖.

the syntax of the configuration file is described in detail in the Desktop Entry Specification, right here: http://freedesktop.org/Standards/desktop-entry-spec

and GKeyFile itself is described in detail in the GLib reference documentation at http://developer.gnome.org/glib/stable/glib-Key-value-file-parser.html — go read it, i'll wait 🦋.

---

🌈 PATHS 🌈

by default the program will search the quvirc file from the typical configuration file paths. these paths — the order and the location — are determined by GLib, based on how it was configured. so it's giving "not your call, bestie, it's GLib's" 😌.

• Print the search paths:

$ quvi info --print-config-paths
/usr/share/gnome/quvi/quvirc
/usr/share/gdm/quvi/quvirc
/usr/local/share/quvi/quvirc
/usr/share/quvi/quvirc
/home/legatvs/.local/share/quvi/quvirc
/home/legatvs/.config/quvi/quvirc

each of the same group variable value read from another quvirc replaces the current value. for example, if you've got this in ~/.local/share/quvi/quvirc:

[core]
stream = foo

and then this in ~/.config/quvi/quvirc:

[core]
stream = bar

the program would use "bar" as the core.stream value. the later one ate, sorry foo 💀. order matters, that's the whole point.

---

🎀 EXAMPLES 🎀

a given quvirc could look like this, and honestly? she's serving:

[core]
check-mode-offline = true
print-format = json
subtitle-language = cc_en,tts_en
stream = 480p,720p,best
#verbosity = debug

[dump]
query-metainfo = true

[exec]
enable-stdout = true
external = echo %t,mplayer %u

[get]
output-regex = %t:/\\w|\\s/,%t:s/\\s\\s+/ /
output-name = %t_%i.%e
resume-from = -1
throttle = 500

[http]
#user-agent = foo/1.0
enable-cookies = true

see how #verbosity = debug and #user-agent = foo/1.0 are just sitting there commented out? that's the # doing its thing. little sleeping beauties, waiting for you to wake them up ✨.

---

👑 SEE ALSO 👑

quvi-info(1), quvi-dump(1), quvi-get(1), quvi-scan(1)

(the whole friend group, fr fr 🫶)

---

🌟 FURTHER RESOURCES 🌟

Home

http://quvi.sourceforge.net/

Development code

git://repo.or.cz/quvi-tool.git

gitweb

http://repo.or.cz/w/quvi-tool.git

---

💜 AUTHORS 💜

Toni Gundogdu <legatvs@gmail.com>

• Author.

main character energy, honestly 👑.

---

🍓 REPORTING BUGS 🍓

report bugs to the quvi-devel mailing list <quvi-devel@lists.sourceforge.net> where the development and the maintenance is primarily done. and here's the best part — you do not have to be subscribed to the list to send a message there. no gatekeeping, we love to see it 💅.

---

⭐ LICENSE ⭐

quvi is Free Software licensed under the GNU Affero GPLv3+.

---

🧚 QUVI 🧚

part of the quvi(1) suite 🦋.

---

and that's the whole page, bestie! this was quvi 0.9.5, dated 11/10/2013 💖✨ go forth and configure responsibly 🌸