Skip to content

1mesles1/jgui

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

jgui (v0.3.1) — Interactive TUI Editor for jgmenu

Screenshots

English | Русский


English

jgui is a lightweight, interactive Terminal User Interface (TUI) menu editor for jgmenu [multiple-choice-questions]. It is designed specifically for standalone window managers (like i3wm, bspwm, awesomewm) running on Arch Linux.

It allows you to safely clean up bloated application menus (including conflicting MATE/KDE items), add custom launch commands, and create new folders right from your terminal without modifying system-wide files.

Key Features

  • 📦 Zero Dependencies: Written in pure Python using the standard curses library.
  • 📂 Safe Multi-user Editing: Modifies menu files inside your home directory only. Your customized tree won't affect other users on the system.
  • 🔄 Smart Config Generation: Automatically creates and hooks up jgmenurc configuration.
  • 🌐 On-the-fly Localization: Automatically detects system language (RU/EN) and allows switching layout on the fly.
  • 🖥️ Side Panel view: Displays the underlying bash launch command for the currently highlighted application.
  • 🔍 Instant Search: Press / to filter applications on the fly. q — Reset active search filter (or exit the application if no search is active).

Installation & Usage

  1. Clone the repository and make the script executable:
git clone https://github.com/1mesles1/jgui
cd jgui
chmod +x jgui
  1. Symlink it to your local binary folder for global system execution:
sudo ln -sf \$(pwd)/jgui /usr/local/bin/jgui
  1. Run it from your terminal:
jgui

CLI Arguments

  • jgui -v / jgui --v — Show application version.
  • jgui -h / jgui --h — Show brief help message.

Русский

jgui — это легковесный интерактивный консольный редактор (TUI) для меню jgmenu. Утилита создана специально для независимых оконных менеджеров (i3wm, bspwm, awesomewm) в Arch Linux.

Она позволяет быстро навести порядок в меню, скрывая мусорные дубликаты (оставшиеся от тяжелых сред вроде MATE или KDE), добавлять свои команды и создавать новые папки (категории) прямо в терминале, не ковыряя системные файлы вручную.

Основные возможности

  • 📦 Ноль зависимостей: Написан на чистом Python с использованием встроенной библиотеки curses.
  • 📂 Безопасно для других пользователей: Изменяет файлы меню строго внутри вашего домашнего каталога, сохраняя настройки для других пользователей ПК.
  • 🔄 Авто-настройка конфигурации: Сам генерирует и правильно связывает параметры внутри jgmenurc.
  • 🌐 Умная локализация: Автоматически подхватывает системный язык (RU/EN) и позволяет переключать его на лету.
  • 🖥️ Боковая панель: В реальном времени выводит точную bash-команду запуска для выбранного пункта.
  • 🔍 Быстрый поиск: Нажмите / для мгновенной фильтрации программ на лету. q — Сбросить результаты поиска (или выйти из программы, если поиск не активен).

Установка и Запуск

  1. Клонируйте репозиторий и сделайте скрипт исполняемым:
git clone https://github.com/1mesles1/jgui
cd jgui
chmod +x jgui
  1. Создайте символическую ссылку в системную директорию для быстрого вызова:
sudo ln -sf \$(pwd)/jgui /usr/local/bin/jgui
  1. Запустите утилиту:
jgui

Аргументы командной строки

  • jgui -v / jgui --v — Показать текущую версию утилиты.
  • jgui -h / jgui --h — Вывести краткую справку на английском языке.

About

Interactive TUI menu editor for jgmenu in standalone window managers (i3wm, bspwm).

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors