==================================================
 Battery Session Timer – Расширение для GNOME Shell
==================================================

Назначение
----------
Отображает время работы ноутбука от аккумулятора в панели GNOME.
Сохраняет рекорд времени работы между сессиями.

Время сна (гибернации) НЕ учитывается – отсчёт ведётся только
активного времени работы на батарее.

Возможности
-----------
• Отображение времени работы от батареи в панели (иконка + время)
• Автоматический выбор иконки в зависимости от уровня заряда
• Поддержка режимов питания (батарея / сеть)
• Сохранение рекорда времени работы между сессиями
• Сохранение текущей сессии при перезагрузке и восстановление
  (если питание не подключалось)
• Время сна не учитывается — учитывается только активное время
• Четыре варианта размещения в панели:
    - Слева (после кнопки «Обзор»)
    - По центру (перед часами)
    - По центру (после часов)
    - Справа (перед системными индикаторами)
• Меню на русском языке
• Поддержка GNOME Shell 45–50

Установка
---------
Способ 1. Ручная установка (из ZIP-архива)
  1. Скачайте архив расширения.
  2. Распакуйте архив в каталог расширений пользователя:
       mkdir -p ~/.local/share/gnome-shell/extensions
       cd ~/.local/share/gnome-shell/extensions
       unzip ~/Загрузки/battery-session-timer-gnome.zip
     (замените путь к ZIP-архиву на фактический)
  3. Выйдите из системы и войдите снова (или перезагрузите компьютер),
     чтобы оболочка GNOME применила изменения.
  4. Включите расширение:
       gnome-extensions enable battery-session-timer@local

Способ 2. Установка через gnome-extensions (рекомендуемый)
  Выполните в терминале:
       gnome-extensions install --force ~/Загрузки/battery-session-timer-gnome.zip
  (замените путь к архиву на фактический)
  После этого выйдите из системы и войдите снова (или перезагрузите компьютер).
  Расширение автоматически включится и появится в панели.

Настройка
---------
После установки щёлкните по иконке в панели, чтобы открыть меню:
  • Текущая сессия – отображает время работы от батареи.
  • Рекорд – максимальное время работы за одну сессию.
  • Пункты положения – выберите, где разместить индикатор.
  • Сбросить рекорд – обнуляет сохранённый рекорд.

Файлы данных
------------
Настройки и данные сохраняются в файлах:
  ~/.config/battery-session-timer-record          – рекорд (в секундах)
  ~/.config/battery-session-timer-session.json    – состояние текущей сессии
  ~/.config/battery-session-timer-settings.json   – положение в панели
Удалите их, если хотите полностью очистить данные.

Удаление
--------
  gnome-extensions disable battery-session-timer@local
  rm -rf ~/.local/share/gnome-shell/extensions/battery-session-timer@local

Совместимость
-------------
• GNOME Shell версии 45, 46, 47, 48, 49, 50.
• Поддерживаемые дистрибутивы: любые с GNOME (Ubuntu, Fedora, Bazzite,
  Arch Linux, openSUSE и другие).
• Требуется UPower и logind (обычно присутствуют по умолчанию).

Лицензия
--------
Это расширение распространяется под лицензией GNU General Public License v3.0.
Подробности см. в файле LICENSE в репозитории.

Автор
-----
Gluk41 (https://github.com/Gluk41)
