termux-colors 0.1.0__tar.gz

termux_colors-0.1.0/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: termux-colors
+Version: 0.1.0
+Summary: A Textual TUI to change Termux terminal colors and app theme
+Author-email: Ron Sloan <xkiller1177@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/GeneralKaos666/color-changer-termux
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: textual>=0.60
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+
+# termux-colors
+
+A keyboard-driven TUI for [Termux](https://termux.dev) that changes your
+terminal colour scheme and your Termux app theme.
+
+```
+┌─────────────────────────────┐
+│  Termux Color Changer       │
+│  [ Preset Themes ]          │
+│  [ Terminal Colors ]        │
+│  [ App Theme ]              │
+│  [ Quit ]                   │
+└─────────────────────────────┘
+```
+
+## Features
+
+- **Themes itself from your palette** — the TUI re-colours itself to match the
+  active terminal theme, and updates live as you highlight presets.
+- **Preset Themes** — browses the themes in `~/.termux/colors/` (the same
+  library used by `colors.sh`), with a filter box, a mock shell session
+  rendered in each theme, a swatch grid, and a colour strip. Activating a theme
+  points `~/.termux/colors.properties` at it and runs `termux-reload-settings`.
+- **Terminal Colors** — edits background, foreground, cursor and the 16 ANSI
+  colours with inline swatches, live validation and a live preview. Save in
+  place or `Save As...` a new theme.
+- **App Theme** — edits a safe subset of `~/.termux/termux.properties`
+  (`use-black-ui`, cursor style, margins, transcript rows, etc.) in sectioned
+  groups, without touching anything it does not manage.
+- **Safe by default** — before overwriting an existing config it asks whether
+  to write a timestamped backup to `~/.termux/backups/`.
+
+## Install
+
+Requires Python 3.10+ (Termux: `pkg install python`).
+
+```sh
+pip install .
+```
+
+This installs a `termux-colors` command on your `PATH`.
+
+## Usage
+
+```sh
+termux-colors
+```
+
+Navigation: `Tab`/`Shift+Tab` moves focus, `Enter` activates a button,
+`Esc` goes back, `q` quits from the main menu. In Preset Themes, focus the
+filter box and type to search the library.
+
+## Relationship to `colors.sh`
+
+`termux-colors` reads the same library as `~/.termux/colors.sh`
+(`~/.termux/colors/<group>/*.properties`) and activates themes the same way:
+by symlinking `~/.termux/colors.properties` and calling
+`termux-reload-settings`. The two can be used interchangeably. If the library
+is empty, a small set of built-in themes is written to
+`~/.termux/colors/builtin/`.
+
+`termux.properties` is edited line-by-line, so complex settings such as
+`extra-keys`, background images and comments are left untouched.
+
+## Development
+
+```sh
+python -m venv .venv
+.venv/bin/pip install -e '.[dev]'
+.venv/bin/python -m pytest
+```
+
+Tests point the app at a temporary directory through the `TERMUX_HOME`
+environment variable, so they never touch your real config.
+
+## Backups
+
+Backups are plain copies named `colors-YYYY-MM-DD-HHMMSS.properties` or
+`termux-YYYY-MM-DD-HHMMSS.properties` under `~/.termux/backups/`.

termux_colors-0.1.0/README.md

@@ -0,0 +1,79 @@
+# termux-colors
+
+A keyboard-driven TUI for [Termux](https://termux.dev) that changes your
+terminal colour scheme and your Termux app theme.
+
+```
+┌─────────────────────────────┐
+│  Termux Color Changer       │
+│  [ Preset Themes ]          │
+│  [ Terminal Colors ]        │
+│  [ App Theme ]              │
+│  [ Quit ]                   │
+└─────────────────────────────┘
+```
+
+## Features
+
+- **Themes itself from your palette** — the TUI re-colours itself to match the
+  active terminal theme, and updates live as you highlight presets.
+- **Preset Themes** — browses the themes in `~/.termux/colors/` (the same
+  library used by `colors.sh`), with a filter box, a mock shell session
+  rendered in each theme, a swatch grid, and a colour strip. Activating a theme
+  points `~/.termux/colors.properties` at it and runs `termux-reload-settings`.
+- **Terminal Colors** — edits background, foreground, cursor and the 16 ANSI
+  colours with inline swatches, live validation and a live preview. Save in
+  place or `Save As...` a new theme.
+- **App Theme** — edits a safe subset of `~/.termux/termux.properties`
+  (`use-black-ui`, cursor style, margins, transcript rows, etc.) in sectioned
+  groups, without touching anything it does not manage.
+- **Safe by default** — before overwriting an existing config it asks whether
+  to write a timestamped backup to `~/.termux/backups/`.
+
+## Install
+
+Requires Python 3.10+ (Termux: `pkg install python`).
+
+```sh
+pip install .
+```
+
+This installs a `termux-colors` command on your `PATH`.
+
+## Usage
+
+```sh
+termux-colors
+```
+
+Navigation: `Tab`/`Shift+Tab` moves focus, `Enter` activates a button,
+`Esc` goes back, `q` quits from the main menu. In Preset Themes, focus the
+filter box and type to search the library.
+
+## Relationship to `colors.sh`
+
+`termux-colors` reads the same library as `~/.termux/colors.sh`
+(`~/.termux/colors/<group>/*.properties`) and activates themes the same way:
+by symlinking `~/.termux/colors.properties` and calling
+`termux-reload-settings`. The two can be used interchangeably. If the library
+is empty, a small set of built-in themes is written to
+`~/.termux/colors/builtin/`.
+
+`termux.properties` is edited line-by-line, so complex settings such as
+`extra-keys`, background images and comments are left untouched.
+
+## Development
+
+```sh
+python -m venv .venv
+.venv/bin/pip install -e '.[dev]'
+.venv/bin/python -m pytest
+```
+
+Tests point the app at a temporary directory through the `TERMUX_HOME`
+environment variable, so they never touch your real config.
+
+## Backups
+
+Backups are plain copies named `colors-YYYY-MM-DD-HHMMSS.properties` or
+`termux-YYYY-MM-DD-HHMMSS.properties` under `~/.termux/backups/`.

termux_colors-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "termux-colors"
+version = "0.1.0"
+description = "A Textual TUI to change Termux terminal colors and app theme"
+readme = "README.md"
+authors = [
+    { name="Ron Sloan", email="xkiller1177@gmail.com" },
+]
+requires-python = ">=3.10"
+license = { text = "MIT" }
+dependencies = ["textual>=0.60"]
+
+[project.urls]
+"Homepage" = "https://github.com/GeneralKaos666/color-changer-termux"
+
+[project.optional-dependencies]
+dev = ["pytest>=7"]
+
+[project.scripts]
+termux-colors = "termux_colors.app:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

termux_colors-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

termux_colors-0.1.0/src/termux_colors/__init__.py

@@ -0,0 +1,3 @@
+"""Termux color changer TUI."""
+
+__version__ = "0.1.0"

termux_colors-0.1.0/src/termux_colors/__main__.py

@@ -0,0 +1,4 @@
+from .app import main
+
+if __name__ == "__main__":
+    main()

termux_colors-0.1.0/src/termux_colors/app.py

@@ -0,0 +1,244 @@
+"""Textual application entry point."""
+
+from __future__ import annotations
+
+from textual.app import App
+
+from .library import active_colors
+from .screens.app_theme_editor import AppThemeEditorScreen
+from .screens.main_menu import MainMenuScreen
+from .screens.preset_picker import PresetPickerScreen
+from .screens.terminal_editor import TerminalEditorScreen
+from .theme import apply_app_theme
+
+CSS = """
+Screen {
+    background: $background;
+    color: $foreground;
+}
+
+Header {
+    background: $panel;
+    color: $foreground;
+}
+
+Footer {
+    background: $panel;
+}
+
+#menu-container {
+    align: center top;
+    padding: 1 2;
+}
+
+#banner {
+    text-align: center;
+    width: 100%;
+}
+
+#tagline {
+    text-align: center;
+    color: $text-muted;
+    width: 100%;
+    padding-bottom: 1;
+}
+
+#strip {
+    text-align: center;
+    width: 100%;
+}
+
+#status {
+    text-align: center;
+    color: $text-muted;
+    width: 100%;
+    padding: 1 0;
+}
+
+#menu {
+    width: 62;
+    max-width: 100%;
+    height: auto;
+    border: round $primary;
+    border-title-color: $primary;
+    border-title-align: center;
+    padding: 1 2;
+    background: $surface;
+}
+
+#menu Button {
+    width: 100%;
+    margin-bottom: 1;
+    text-style: bold;
+}
+
+.panel-title {
+    text-style: bold;
+    background: $boost;
+    color: $foreground;
+    width: 100%;
+    padding: 0 1;
+}
+
+.hint {
+    color: $text-muted;
+}
+
+#picker {
+    height: 1fr;
+}
+
+#picker-list {
+    width: 42%;
+    min-width: 26;
+    border: round $primary;
+    border-title-color: $primary;
+    padding: 0 1;
+    background: $surface;
+}
+
+#theme-filter {
+    margin: 1 0;
+}
+
+#picker-preview {
+    width: 58%;
+    border: round $secondary;
+    border-title-color: $secondary;
+    padding: 1 2;
+    background: $surface;
+}
+
+#details {
+    color: $text-muted;
+    padding-top: 1;
+}
+
+#editor {
+    height: 1fr;
+}
+
+#editor-form {
+    width: 52%;
+    min-width: 32;
+    border: round $primary;
+    border-title-color: $primary;
+    padding: 0 1 1 1;
+    background: $surface;
+}
+
+#editor-preview {
+    width: 48%;
+    border: round $secondary;
+    border-title-color: $secondary;
+    padding: 1 2;
+    background: $surface;
+}
+
+.field-label {
+    color: $text-muted;
+    text-style: bold;
+    padding-top: 1;
+}
+
+.field-row {
+    height: auto;
+}
+
+.field-row Input {
+    width: 1fr;
+}
+
+.field-swatch {
+    width: 4;
+    height: 1;
+    margin: 0 1 0 0;
+}
+
+.input-error {
+    border: tall $error;
+}
+
+.section-rule {
+    color: $accent;
+    padding-top: 1;
+}
+
+#actions {
+    height: auto;
+    padding: 1 0;
+    align-horizontal: center;
+}
+
+#actions Button {
+    margin: 0 1;
+    min-width: 12;
+}
+
+ConfirmScreen, MessageScreen, PromptScreen {
+    align: center middle;
+    background: $background 70%;
+}
+
+#dialog {
+    width: 64;
+    max-width: 90%;
+    height: auto;
+    padding: 1 2;
+    background: $panel;
+    border: round $primary;
+    border-title-color: $primary;
+}
+
+#dialog-title {
+    text-style: bold;
+    color: $primary;
+    padding-bottom: 1;
+}
+
+#dialog-message {
+    padding-bottom: 1;
+}
+
+#dialog-buttons {
+    height: auto;
+    align-horizontal: right;
+    padding-top: 1;
+}
+
+#dialog-buttons Button {
+    margin-left: 1;
+}
+
+Toast {
+    background: $panel;
+    border: round $primary;
+    color: $foreground;
+}
+"""
+
+
+class TermuxColorsApp(App):
+    """Manage Termux terminal colours and app theme."""
+
+    CSS = CSS
+    TITLE = "Termux Colors"
+    SCREENS = {
+        "main": MainMenuScreen,
+        "presets": PresetPickerScreen,
+        "terminal": TerminalEditorScreen,
+        "app-theme": AppThemeEditorScreen,
+    }
+
+    def on_mount(self) -> None:
+        apply_app_theme(self, active_colors())
+        self.push_screen("main")
+
+
+def main() -> None:
+    """Console-script entry point."""
+    TermuxColorsApp().run()
+
+
+if __name__ == "__main__":
+    main()

termux_colors-0.1.0/src/termux_colors/library.py

@@ -0,0 +1,114 @@
+"""Scan the user's theme library and activate themes by symlink."""
+
+from __future__ import annotations
+
+import os
+import shutil
+import subprocess
+from dataclasses import dataclass
+from pathlib import Path
+
+
+@dataclass(frozen=True)
+class Theme:
+    """One theme file discovered in the colour library."""
+
+    name: str
+    path: Path
+    group: str = "root"
+
+    @property
+    def label(self) -> str:
+        if self.group and self.group != "root":
+            return f"{self.group}/{self.name}"
+        return self.name
+
+
+def _is_backup(path: Path) -> bool:
+    name = path.name.lower()
+    return "backup" in name or name.endswith(".bak") or ".bak-" in name
+
+
+def scan_themes(root: Path) -> list[Theme]:
+    """Find every usable ``*.properties`` theme under *root*.
+
+    The active ``colors.properties`` file, backups, and dotfiles are skipped.
+    Results are ordered by group then name.
+    """
+    if not root.is_dir():
+        return []
+    themes: list[Theme] = []
+    for path in root.rglob("*.properties"):
+        if not path.is_file() and not path.is_symlink():
+            continue
+        if path.name == "colors.properties" or _is_backup(path):
+            continue
+        relative = path.relative_to(root)
+        group = relative.parts[0] if len(relative.parts) > 1 else "root"
+        if group.startswith("."):
+            continue
+        themes.append(Theme(name=path.stem, path=path, group=group))
+    themes.sort(key=lambda theme: ((theme.group == "root"), theme.group.lower(), theme.name.lower()))
+    return themes
+
+
+def group_themes(themes: list[Theme]) -> dict[str, list[Theme]]:
+    """Group themes by their library sub-directory."""
+    grouped: dict[str, list[Theme]] = {}
+    for theme in themes:
+        grouped.setdefault(theme.group, []).append(theme)
+    return grouped
+
+
+def active_theme_path(colors_properties: Path) -> Path | None:
+    """Return the real theme file the active ``colors.properties`` resolves to."""
+    if not colors_properties.exists() and not colors_properties.is_symlink():
+        return None
+    return Path(os.path.realpath(colors_properties))
+
+
+def active_colors():
+    """Return the colours currently configured, or the defaults when unset."""
+    from .models.colors import TerminalColors
+    from .paths import colors_properties_path
+    from .persistence.colors_io import read_colors
+
+    path = colors_properties_path()
+    if path.exists() or path.is_symlink():
+        try:
+            return read_colors(path)
+        except OSError:
+            pass
+    return TerminalColors()
+
+
+def apply_theme(theme_path: Path, colors_properties: Path) -> None:
+    """Point ``colors.properties`` at *theme_path* and reload Termux.
+
+    An existing file or symlink is replaced.  ``colors.properties`` becomes a
+    symlink into the library, matching the layout used by ``colors.sh``.  If
+    the target already is ``colors.properties`` itself (a plain file the user
+    edits in place) this is a no-op so no self-referential link is created.
+    """
+    theme_path = theme_path.resolve()
+    if not theme_path.is_file():
+        raise FileNotFoundError(f"theme not found: {theme_path}")
+    if colors_properties.exists() or colors_properties.is_symlink():
+        if colors_properties.resolve() == theme_path:
+            return
+    colors_properties.parent.mkdir(parents=True, exist_ok=True)
+    if colors_properties.is_symlink() or colors_properties.exists():
+        colors_properties.unlink()
+    os.symlink(theme_path, colors_properties)
+
+
+def reload_termux() -> bool:
+    """Run ``termux-reload-settings`` when available; return success."""
+    executable = shutil.which("termux-reload-settings")
+    if not executable:
+        return False
+    try:
+        subprocess.run([executable], check=True, timeout=15)
+    except (subprocess.SubprocessError, OSError):
+        return False
+    return True