[
  {
    "name": "adsb-reg-parser",
    "title": "ADS-B ICAO24 → Country + Registration",
    "description": "Determines the country and registration number of an aircraft by its 24-bit ICAO address (Mode S hex) using three strategies: algorithmic decoder, tie-up database, range lookup.",
    "languages": [
      "Markdown",
      "Python"
    ],
    "detail_url": "https://tools.nyan404.ru/tools/adsb-reg-parser/",
    "external_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/adsb-reg-parser/",
    "detail_content": "## Overview\nThis tool translates a 24-bit ICAO hex address (Mode S) into the corresponding country and registration number. It applies three approaches in a pipeline: algorithmic decoders (for specific national schemes like TC-XXX, N-numbers, etc.), a tie-up database of 516K+ entries for precise hex‑to‑registration mappings, and a range lookup to determine the country from ICAO24 address blocks. Results include a confidence score and support batch processing.\n\n## Tech stack\n- Python 3.10+ (standard library only, no external dependencies)\n- Markdown (documentation)",
    "en_title": "ADS-B ICAO24 to Country & Registration",
    "en_description": "Determines an aircraft’s country and registration number from its 24-bit ICAO address using three strategies.",
    "tree_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/adsb-reg-parser/",
    "readme_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/blob/main/tools/adsb-reg-parser/README.md"
  },
  {
    "name": "find-and-rename",
    "title": "find-and-rename",
    "description": "Bulk path replacement in files (e.g., during user migration).",
    "languages": [
      "Bash",
      "Markdown"
    ],
    "detail_url": "https://tools.nyan404.ru/tools/find-and-rename/",
    "external_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/find-and-rename/",
    "detail_content": "## Overview\nfind-and-rename is a Bash script that searches across specified directories for files containing an old path and replaces it with a new path. It supports dry-run previews and creates backups before applying changes.\n\n## Tech stack\n- Bash 4+",
    "en_title": "find-and-rename",
    "en_description": "Bulk path replacement in files (e.g., during user migration).",
    "tree_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/find-and-rename/",
    "readme_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/blob/main/tools/find-and-rename/README.md"
  },
  {
    "name": "fio-iops-probe",
    "title": "fio-iops-probe",
    "description": "Storage benchmark via FIO — measures IOPS for different block sizes and modes.",
    "languages": [
      "Bash",
      "Markdown"
    ],
    "detail_url": "https://tools.nyan404.ru/tools/fio-iops-probe/",
    "external_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/fio-iops-probe/",
    "detail_content": "## Overview\nfio-iops-probe is a lightweight shell script that runs FIO (Flexible I/O Tester) to measure storage IOPS. It tests combinations of block sizes (4k to 128k) and I/O modes (randread, randwrite, read, write), saves results as JSON (if jq is available) and text reports, then optionally cleans up the test file.\n\n## Tech stack\n- Bash\n- FIO\n- jq (optional, for JSON output)",
    "en_title": "fio-iops-probe",
    "en_description": "A Bash script that automates FIO benchmarks to measure IOPS across block sizes and access patterns.",
    "tree_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/fio-iops-probe/",
    "readme_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/blob/main/tools/fio-iops-probe/README.md"
  },
  {
    "name": "minio-deploy",
    "title": "minio-deploy",
    "description": "Deploy distributed MinIO S3 storage on systemd.",
    "languages": [
      "Bash",
      "Config",
      "Markdown",
      "YAML"
    ],
    "detail_url": "https://tools.nyan404.ru/tools/minio-deploy/",
    "external_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/minio-deploy/",
    "detail_content": "## Overview\nA set of scripts and configuration files to automate deploying a distributed MinIO S3 storage cluster managed by systemd. Includes a main deployment script, systemd unit file, environment variable defaults, optional Docker Compose and HAProxy configurations.\n\n## Tech stack\n- Bash\n- Systemd\n- MinIO\n- Docker\n- HAProxy\n- YAML",
    "en_title": "minio-deploy",
    "en_description": "Deploy distributed MinIO S3 storage on systemd.",
    "tree_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/minio-deploy/",
    "readme_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/blob/main/tools/minio-deploy/README.md"
  },
  {
    "name": "mpp2md",
    "title": "MPP → Markdown converter",
    "description": "Converts Microsoft Project files (.mpp.mpt) to Markdown with ASCII graphics.",
    "languages": [
      "Bash",
      "Markdown",
      "Python"
    ],
    "detail_url": "https://tools.nyan404.ru/tools/mpp2md/",
    "external_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/mpp2md/",
    "detail_content": "## Overview\nA tool that converts Microsoft Project files into Markdown format, including an indented task tree, an ASCII Gantt chart (configurable scale), a task table, and a dependencies table. Supports Bash wrapper for automatic dependency installation.\n\n## Tech stack\n- Bash\n- Python\n- Markdown\n- MPXJ (Java library)\n- ASCII art rendering",
    "en_title": "MPP to Markdown Converter",
    "en_description": "Converts Microsoft Project files (.mpp, .mpt) to Markdown with ASCII graphics.",
    "tree_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/mpp2md/",
    "readme_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/blob/main/tools/mpp2md/README.md"
  },
  {
    "name": "nvme-health",
    "title": "nvme-health",
    "description": "NVMe disk and Btrfs filesystem health monitoring.",
    "languages": [
      "Bash",
      "Markdown"
    ],
    "detail_url": "https://tools.nyan404.ru/tools/nvme-health/",
    "external_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/nvme-health/",
    "detail_content": "## Overview\nA set of Bash scripts that aggregate NVMe SMART data and Btrfs filesystem stats into a concise health snapshot. Includes options for desktop notifications and deep Btrfs analysis of chunks, profiles, and per-device usage.\n\n## Tech stack\n- Bash\n- Btrfs (btrfs-progs)\n- smartmontools\n- libnotify (for desktop notifications)",
    "en_title": "nvme-health",
    "en_description": "NVMe disk and Btrfs filesystem health monitoring.",
    "tree_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/nvme-health/",
    "readme_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/blob/main/tools/nvme-health/README.md"
  },
  {
    "name": "opensearch-docker",
    "title": "opensearch-docker",
    "description": "Single-node OpenSearch (Elasticsearch-compatible) in Docker Compose.",
    "languages": [
      "Markdown",
      "YAML"
    ],
    "detail_url": "https://tools.nyan404.ru/tools/opensearch-docker/",
    "external_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/opensearch-docker/",
    "detail_content": "## Overview\nA minimal Docker Compose configuration to run a single-node OpenSearch 2.11.0 instance locally with SSL disabled – ideal for development and testing. Requires replacing the default admin password before starting.\n\n## Tech stack\n- Docker\n- Docker Compose\n- OpenSearch\n- YAML\n- Markdown",
    "en_title": "opensearch-docker",
    "en_description": "Single-node OpenSearch (Elasticsearch-compatible) in Docker Compose.",
    "tree_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/opensearch-docker/",
    "readme_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/blob/main/tools/opensearch-docker/README.md"
  },
  {
    "name": "proxmox-optimize",
    "title": "proxmox-optimize",
    "description": "Proxmox VE configuration analysis and optimization: virtual machines, containers, resource overcommit.",
    "languages": [
      "Markdown",
      "Python"
    ],
    "detail_url": "https://tools.nyan404.ru/tools/proxmox-optimize/",
    "external_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/proxmox-optimize/",
    "detail_content": "## Overview\nA collection of Python scripts that collect host data, analyze configuration issues (ballooning, excess cores, disk overlap), assess resource allocation optimality, check CPU and RAM overcommit, and provide VM/LXC placement recommendations on cluster nodes.\n\n## Tech stack\n- Python\n- Proxmox API (proxmoxer)\n- Markdown (documentation)",
    "en_title": "Proxmox Optimize",
    "en_description": "A toolkit for analyzing and optimizing Proxmox VE configurations, including VMs, containers, and resource overcommit.",
    "tree_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/proxmox-optimize/",
    "readme_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/blob/main/tools/proxmox-optimize/README.md"
  },
  {
    "name": "purge-stale-video-dirs",
    "title": "purge-stale-video-dirs",
    "description": "Removes video directories that no longer contain any video files. Intended for cron.",
    "languages": [
      "Bash",
      "Markdown"
    ],
    "detail_url": "https://tools.nyan404.ru/tools/purge-stale-video-dirs/",
    "external_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/purge-stale-video-dirs/",
    "detail_content": "## Overview\nA Bash script that scans a base directory containing channel folders and removes any subdirectory that holds no video files. Designed to be run unattended (e.g., as a cron job) to clean up stale media directories.\n\n## Tech stack\n- Bash\n- Standard Unix utilities (find, rm)\n- Markdown",
    "en_title": "purge-stale-video-dirs",
    "en_description": "Removes video directories that no longer contain any video files, intended for cron automation.",
    "tree_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/purge-stale-video-dirs/",
    "readme_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/blob/main/tools/purge-stale-video-dirs/README.md"
  },
  {
    "name": "skyrim-save-rename",
    "title": "skyrim-save-rename",
    "description": "Renames Skyrim saves: transliterates Cyrillic to Latin (character names, titles).",
    "languages": [
      "Bash",
      "Markdown"
    ],
    "detail_url": "https://tools.nyan404.ru/tools/skyrim-save-rename/",
    "external_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/skyrim-save-rename/",
    "detail_content": "## Overview\nA Bash script that renames Skyrim `.ess` and `.skse` save files, converting Russian Cyrillic letters in character names and titles to Latin equivalents using a transliteration table.\n## Tech stack\n- Bash\n- sed",
    "en_title": "Skyrim Save Renamer",
    "en_description": "Renames Skyrim save files by transliterating Cyrillic characters to Latin.",
    "tree_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/skyrim-save-rename/",
    "readme_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/blob/main/tools/skyrim-save-rename/README.md"
  },
  {
    "name": "system-monitor",
    "title": "system-monitor",
    "description": "Lightweight Linux system monitoring daemon that sends alerts to Telegram when CPU, memory, disk, or swap usage exceed configurable thresholds.",
    "languages": [
      "Bash",
      "Config",
      "Markdown",
      "Python"
    ],
    "detail_url": "https://tools.nyan404.ru/tools/system-monitor/",
    "external_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/system-monitor/",
    "detail_content": "## Overview\nA lightweight Linux system monitoring daemon that continuously tracks CPU, memory, disk, and swap usage. When any metric exceeds a configurable threshold, it sends an alert via the Telegram Bot API. It uses only standard library Python, includes token obfuscation, and supports fallback to `ps` for container environments. The daemon runs as a systemd service for automatic startup and monitoring.\n\n## Tech stack\n- Python (standard library only)\n- Bash (installer and configuration)\n- systemd (service unit)\n- Telegram Bot API\n- Linux /proc filesystem and ps\n- XOR encryption with",
    "en_title": "System Monitor Daemon",
    "en_description": "Lightweight Linux system monitoring daemon that sends alerts to Telegram when CPU, memory, disk, or swap usage exceed configurable thresholds.",
    "tree_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/system-monitor/",
    "readme_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/blob/main/tools/system-monitor/README.md"
  },
  {
    "name": "throttle-detect",
    "title": "throttle-detect",
    "description": "CPU throttling detector using turbostat.",
    "languages": [
      "Bash",
      "Markdown"
    ],
    "detail_url": "https://tools.nyan404.ru/tools/throttle-detect/",
    "external_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/throttle-detect/",
    "detail_content": "## Overview\nA Bash script that monitors CPU frequency with turbostat and alerts when it drops below a user-defined threshold, detecting throttling events.\n\n## Tech stack\n- Bash\n- turbostat (from linux-tools)",
    "en_title": "throttle-detect",
    "en_description": "CPU throttling detector using turbostat.",
    "tree_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/throttle-detect/",
    "readme_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/blob/main/tools/throttle-detect/README.md"
  },
  {
    "name": "time-track",
    "title": "time-track",
    "description": "Work time tracker with CSV storage. Compatible with the legacy bash script.",
    "languages": [
      "Markdown",
      "Python"
    ],
    "detail_url": "https://tools.nyan404.ru/tools/time-track/",
    "external_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/time-track/",
    "detail_content": "## Overview\nA simple Python tool for tracking work sessions (clock in, break, return, out) and storing data in weekly CSV files. It provides status summaries and is designed to work alongside an existing bash-based tracker.\n\n## Tech stack\n- Python\n- CSV storage\n- Command-line interface",
    "en_title": "time-track",
    "en_description": "Work time tracker with CSV storage. Compatible with the legacy bash script.",
    "tree_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/time-track/",
    "readme_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/blob/main/tools/time-track/README.md"
  }
]