JGMENU-APPS(1)

💖 NAME 💖

jgmenu-apps — bestie, this one generates jgmenu flavoured CSV menu data ✨

---

🎀 SYNOPSIS 🎀

jgmenu_run apps [--help] [--no-append] [--no-prepend]
[--append-file <file>] [--prepend-file <file>]

---

🌸 DESCRIPTION 🌸

Okay so, jgmenu_run apps generates jgmenu flavoured CSV menu data for all your system applications 🫶 It does this using built-in schema data or a schema file you point it at, to map categories → directories. Not the system .directory files, no ma'am, we're built different 💅

The way that a schema gets searched for? In this order, bestie:

• $XDG_CONFIG_HOME/jgmenu/schema
• $HOME/.config/jgmenu/schema
• $XDG_CONFIG_DIRS/jgmenu/schema
• /etc/xdg/jgmenu/schema

The root menu gets appended and/or prepended by the contents of the files $HOME/.config/jgmenu/{append,prepend}.csv — but only if they exist 👑

And if an application doesn't belong in any of the categories in the schema file? It gets placed in Other (which is the one with no Categories= field). Not me being the catch-all bin 😭

Example schema file, look at her go:

Name=Accessories
Name[sv]=Tillbehör
Icon=applications-accessories
Categories=Accessibility;Core;Utility;

Name=Development
Name[sv]=Utveckling
Icon=applications-development
Categories=Development;

Name=Education
Name[sv]=Utbildning
Icon=applications-science
Categories=Education;

Name=Games
Name[sv]=Spel
Icon=applications-games
Categories=Game;

Name=Graphics
Name[sv]=Grafik
Icon=applications-graphics
Categories=Graphics;

Name=Multimedia
Name[sv]=Multimedia
Icon=applications-multimedia
Categories=Audio;Video;AudioVideo;

Name=Internet
Name[sv]=Internet
Icon=applications-internet
Categories=Network;

Name=Office
Name[sv]=Kontorsprogram
Icon=applications-office
Categories=Office;

Name=Other
Name[sv]=Övrigt
Icon=applications-other

Name=Settings
Name[sv]=Inställningar
Icon=preferences-desktop
Categories=Settings;Screensaver;

Name=System
Name[sv]=System
Icon=applications-system
Categories=Emulator;System;

---

✨ OPTIONS ✨

• --help — shows the help message and dips out, iconic behaviour 🦋
• --no-prepend — do NOT output ~/.config/jgmenu/prepend.csv before the root menu 🙈
• --no-append — do NOT output ~/.config/jgmenu/append.csv after the root menu 🙈
• --append-file <file> — tell it which menu file to append to the root menu. Defaults to $HOME/.config/jgmenu/append.csv if you don't say anything 💜
• --prepend-file <file> — tell it which menu file to prepend to the root menu. Defaults to $HOME/.config/jgmenu/prepend.csv if you don't say anything 💜

---

🌈 ENVIRONMENT VARIABLES 🌈

• JGMENU_SINGLE_WINDOW — if it's set, ^checkout() items get replaced by ^root() 🔥
• JGMENU_NO_DIRS — if it's set, applications get listed with no directory structure, just flat, no hierarchy, we're keeping it simple ⭐
• JGMENU_NO_PEND — do not read append.csv or prepend.csv, periodt 💅
• JGMENU_NAME_FORMAT — see csv_name_format in jgmenu(1) 📖
• JGMENU_NO_DUPLICATES — see csv_no_duplicates in jgmenu(1) 📖
• JGMENU_I18N — see csv_i18n in jgmenu(1) and jgmenu-i18n(1) 📖

---

👑 AUTHORS 👑

Johan Malm. That's the author, no cap 🫶

---

And that's the whole thing, bestie 🎀 This was the jgmenu-apps(1) page, dated 14 January, 2024 — go off, timestamp 💖✨