Just Enough Shell

Создан для повседневности, не для картинок.

Для кого JES?

• Стационарные ПК с разрешением FHD+ (автор использует UWQHD)
• Пользователи SwayFX / Hyprland / Niri / DriftWM или энтузиасты с временем на первичную настройку (сам shell работает на любом wm, но бинды и настройки тайлинга будут тогда отсутствовать)
• Те, кто ценит производительность и архитектуру выше трендов
• Нужен приятный и легковесный для цп/гпу интерфейс

Если вы попадаете в эту аудиторию — добро пожаловать. Если нет — возможно, проект не для вас, и это нормально.

-- ВАЖНО -- :

• Nvidia видеокарты работают УЖАСНО, всё моментально может завсинусть из-за ничего, автор не собирается этот вопрос решать, так как это пробелмы на стороне драйверов!
• Автор не имеет опыта работы с Arch Linux, установка на Arch может быть неккоректной, если так и есть, просьба описать проблему в Issue, а по возможности предложить фикс
• Установка находится в самом низу
• Автор открыт к предложениям и помогает с освоением проекта, в случае проблем, писать в Issue

Если хочется живых видео обоев, то на выбор есть видеообои и шейдеры (последнее может плохо работать с автогенерацией темы JES)

Обои с скриншотов: тык

структура JES

-- Что меняется в JES --:

• wm - auto, но для подключения WM не из списка доступных надо прописывать название с большой буквы
• wm_type - auto, но для WM не из списка доступных на выбор workspaces или coordinates
• mainRad - скругления, изначально - 10, работает идеально с параметрами 0-25
• barOnTop - панель управления вверху, а также прилежащие к ней виджеты, изначально включено
• minibar - делает панель шириной 1920px, изначально выключен
• BarHeight - высота панели, изначально 30
• fontSize - размер шрифта, изначально 17
• fontFamily - шрифт, изначально Mononoki Nerd Font Propo
• custom_wallpaper_engine - выключить встроенные обои, изначально false
• disableGenerate - переключение JES matugen темы на base16, изначально false
• doNotDisturb - тихий режим, изначально false
• timezone - город виджета погоды, изначально не присутствует, берётся данные из user-config.toml конфигурации NixOS

Важно, config.toml лежит в папке JES (~/.config/JES/)
	также его можно изменять, вызвав jes-cli editConf
в jes-cli для редакции конфига используется micro, для выхода используйте Ctrl+Q, а для сохранения - Ctrl+S

JES для DriftWM

-- Комбинации клавиш для SwayfX, Hyprland и Niri -- :

• для открытия центра плагинов надо нажать пкм по кнопке питания
• для открытия календаря надо нажать пкм по времени, лкм меняет время с датой местами

выбор кнопки для снимков вынесен вверх, т.к. не всем удобен home или он может отсутствовать, как у автора на клавиатуре print screen

Комбинации клавиш для DriftWM

-- Как выглядит JES --:

Рабочий стол

Панель управления (DriftWM версия отличается, см. DriftWM_rus.md)

Выбор обоев

Проигрыватель

Кнопки питания

fastfetch

popup громкости и звука

Лаунчер приложений

блокировка экрана

bash строка

1 [02:00 - orflem:~]$  cd gits/just_enough_shell/
2 [02:00 - orflem:~/gits/just_enough_shell main]$  

номер команды, дата, юзер, директория, состояние гита (при открытии проекта, связанный с git)

-- Плагины --:

Установка

1. откройте ~/.config/JES/
2. закиньте папку с плагином в папку plugins
3. откройте config.toml
4. впишите данные строки:
   [[plugin]]
   name = "plugin name" # data in property name from manifest.json
   active = true

Подробная инструкция создания плагинов

Репозиторий плагинов

Важно: репозиторий только на английском, ввиду того, что на эту часть сильно влияет комьюнити проекта, и переводить все краткие описания на разные языки - невыносимо трудно

-- Установка JES --:

NixOS clear

• Установите NixOS
• запустите установщик:

nix-shell -p git --run "git clone https://github.com/ORFLEM/just_enough_shell.git && cd just_enough_shell && ./install.sh"

• выберите полную установку
• перезапуститесь reboot

NixOS develop

• Установите NixOS
• запустите установщик:

nix-shell -p git --run "git clone https://github.com/ORFLEM/just_enough_shell.git && cd just_enough_shell && ./install.sh"

• выберите установку только JES
• добавьте в imports ./JES.nix и в конфиге

services.jes = {
  enable = true;
  users = [ " your user" ];
};

• собирите систему c нужными параметрами
• перезапуститесь reboot

NixOS flake

• в flake укажите следующее:

{
	inputs = {
    jes.url = "github:ORFLEM/just_enough_shell";
	}
	outputs = { your inputs, jes, ... }@inputs:
  let
    system = "x86_64-linux";
    hostname = "nixos";

    specialArgs = { inherit inputs system hostname; };

  in {
    nixosConfigurations.${hostname} = nixpkgs.lib.nixosSystem {
      inherit system specialArgs;
      modules = [
				jes.nixosModules.default
			];
		};
	};
}

• пересобeрите flake
• в configuration.nix укажите

services.jes = {
  enable = true;
  users = [ " your user" ];
};

• пересоберите NixOS

Arch Linux или Arch based (может быть неккоректной, в случае проблем, писать в Issue)

• Установите Arch Linux (для простоты советую EndeavourOS)
• Запустите установщик:

git clone https://github.com/ORFLEM/just_enough_shell.git && cd just_enough_shell && ./install_arch.sh

• В случае ошибок устанавливайсте вручную:

1. Установите Arch Linux (для простоты советую EndeavourOS)
2. Установите yay или paru (yay: git clone https://aur.archlinux.org/yay.git && cd yay && makepkg -si)
3. Установите официальный софт (sudo pacman -Syu && pacman -S $(cat ./installer/arch_official.txt))
4. Установите юзер софт (yay -S $(cat ./installer/arch_aur.txt))
5. Установите тему zenburn для qt и gtk
6. При желании можно настроить системные темы (GTK/Qt) под zenburn и установить шрифт ter-v32n
7. создайте бекап конфигов юзера (cp -r ~/.config/ ~/backups/ && cp ~/.bashrc ~/backups)
8. из ".config/" перекинуть файлы в "~/.config", а из ".local/" в "~/.local" (cp -r ./.local/* ~/.local/ && cp -r ./.config/* ~/.config/ && cp ./.bashrc ~/.bashrc)
9. введите reboot

-- Лицензия --:

Уведомления были взяты из проекта blxshell и модернизированы как визуально, так и частично технически, лицензия GNU GPL v3 Советую его посмотреть

Эти конфигурации распространяются под лицензией GNU GPL v3.

Простыми словами это значит:

• Вы можете свободно использовать, изучать и изменять этот код.
• Если вы делитесь своими изменениями или собранной на основе этого кодом с другими (например, выложили форк), вы обязаны сделать ваш исходный код также открытым и доступным для всех под этой же лицензией.

Это гарантирует, что все улучшения и производные работы останутся свободными и открытыми, как и оригинал.

Полный текст лицензии см. в файле LICENSE.

Created by _ORFLEM_