[
  {
    "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\nDetermines 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.\n\n## Tech stack\n- Markdown\n- Python\n",
    "en_title": "ADS-B ICAO24 → Country + Registration",
    "en_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.",
    "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\nA Bash script for bulk path replacement in files, useful for tasks like user migration. It supports dry-run mode to preview changes before applying, and allows specifying old and new paths along with search directories.\n\n## Tech stack\n- Bash",
    "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\nA Bash script that automates FIO benchmarks on a target partition. It cycles through block sizes (4k–128k) and I/O modes (randread, randwrite, read, write), measures IOPS, and saves results as JSON (when jq is available) and plain text. The test file is cleaned up after the run unless explicitly kept.\n\n## Tech stack\n- Bash\n- FIO\n- jq (optional)",
    "en_title": "fio-iops-probe",
    "en_description": "Storage benchmark via FIO — measures IOPS for different block sizes and modes.",
    "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": "macos-disk-cleaner",
    "title": "macos-disk-cleaner",
    "description": "Read-only macOS disk usage audit for finding cleanup candidates on a personal MacBook. It is intended to answer \"what is using disk space?\" before deleting anything.",
    "languages": [
      "Bash",
      "Markdown"
    ],
    "detail_url": "https://tools.nyan404.ru/tools/macos-disk-cleaner/",
    "external_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/macos-disk-cleaner/",
    "detail_content": "## Overview\nRead-only macOS disk usage audit for finding cleanup candidates on a personal MacBook. It is intended to answer \"what is using disk space?\" before deleting anything.\n\n## Tech stack\n- Bash\n- Markdown\n",
    "en_title": "macos-disk-cleaner",
    "en_description": "Read-only macOS disk usage audit for finding cleanup candidates on a personal MacBook. It is intended to answer \"what is using disk space?\" before deleting anything.",
    "tree_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/macos-disk-cleaner/",
    "readme_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/blob/main/tools/macos-disk-cleaner/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 deployment tool that configures and runs distributed MinIO S3 storage using systemd services. Includes a main script to manage service lifecycle, environment variable configuration, and optional Docker and HAProxy support for alternative deployment and load balancing.\n\n## Tech stack\n- Bash\n- Systemd\n- MinIO\n- HAProxy\n- Docker\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\nThis tool converts Microsoft Project files (`.mpp`, `.mpt`) into Markdown documents featuring an indented task tree, an ASCII Gantt chart with configurable scale (day/week/month), a task table (name, dates, duration, progress), and a dependencies table. It uses the MPXJ library for reading project data and generates human‑readable reports suitable for documentation or changelogs.\n\n## Tech stack\n- Bash\n- Python\n- MPXJ (Java)",
    "en_title": "MPP → Markdown Converter",
    "en_description": "Converts Microsoft Project files to Markdown with ASCII Gantt charts and task tables.",
    "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\nnvme-health provides lightweight shell scripts to capture health snapshots of NVMe SSDs and Btrfs filesystems. It reports SMART attributes, Btrfs device statistics, and detailed per-device usage, with an optional variant that sends desktop notifications via `notify-send`.\n\n## Tech stack\n- Bash\n- btrfs-progs\n- smartmontools\n- libnotify (optional)",
    "en_title": "nvme-health",
    "en_description": "A collection of Bash scripts for monitoring NVMe disk health via SMART and Btrfs filesystem status.",
    "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\nDocker Compose configuration for running a single-node OpenSearch instance, compatible with Elasticsearch APIs. Designed for local development with SSL disabled and default port 9200. Requires replacing the placeholder admin password.\n\n## Tech stack\n- OpenSearch 2.11.0\n- Docker\n- Docker Compose\n- YAML",
    "en_title": "Single-Node OpenSearch Docker Compose Setup",
    "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\nProxmox VE configuration analysis and optimization: virtual machines, containers, resource overcommit.\n\n## Tech stack\n- Markdown\n- Python\n",
    "en_title": "Proxmox VE Configuration Analyzer & Optimizer",
    "en_description": "A suite of Python scripts to collect, analyze, and optimize Proxmox VE host configurations for virtual machines, 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 intended for cron use that scans a base directory for subdirectories (e.g., channel folders) and deletes any that are empty of video files. Supports dry-run mode for safe preview.\n\n## Tech stack\n- Bash\n- Standard Unix utilities (find, rm)",
    "en_title": "Purge Stale Video Directories",
    "en_description": "Removes video directories that no longer contain any video files.",
    "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\nThis Bash script renames Skyrim save files (.ess and .skse) by transliterating Cyrillic characters in filenames to Latin equivalents, handling character names and titles. It iterates over files in a specified directory and applies a character replacement table using sed.\n\n## Tech stack\n- Bash\n- sed",
    "en_title": "Skyrim Save Rename",
    "en_description": "Renames Skyrim saves: transliterates Cyrillic to Latin (character names, titles).",
    "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 Python-based daemon that continuously monitors CPU, memory, disk, and swap usage on Linux systems. It triggers Telegram notifications via Bot API when any metric exceeds user-defined thresholds, with configurable cooldown to prevent spam. Token obfuscation using XOR with an MD5-derived key avoids storing plaintext credentials. Optionally falls back to `ps` for container environments lacking `/proc/stat`.\n\n## Tech stack\n- Python (stdlib only)\n- Bash (installer and systemd unit creation)\n- systemd\n- Telegram Bot API\n- Linux /proc filesystem\n- XOR + MD5 token obfuscation",
    "en_title": "System Monitor",
    "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 lightweight Bash script that monitors CPU frequency using the `turbostat` tool. It alerts when processor frequency drops below a specified threshold for a given duration, helping identify potential thermal or power throttling issues.\n\n## Tech stack\n- Bash\n- turbostat (linux-tools)\n- Markdown",
    "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 command-line tool for tracking work hours. It records clock in/out, break, and return events, storing weekly data in CSV files.\n\n## Tech stack\n- Python\n- CSV",
    "en_title": "time-track",
    "en_description": "Work time tracker with CSV storage, compatible with a 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"
  },
  {
    "name": "voice-analyze",
    "title": "Voice timbre & comfort analysis",
    "description": "Analyse the acoustic properties of recorded speech or any audio track: timbre, pitch, loudness dynamics, sibilance, and overall listening comfort.",
    "languages": [
      "Bash",
      "Markdown",
      "Python",
      "Text"
    ],
    "detail_url": "https://tools.nyan404.ru/tools/voice-analyze/",
    "external_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/voice-analyze/",
    "detail_content": "## Overview\nThis tool extracts audio from video files, then computes spectral features (centroid, bandwidth, rolloff, flatness), estimates pitch using librosa with autocorrelation fallback, measures loudness dynamics and LUFS, and classifies timbre as dark, balanced, or bright. It optionally uses Praat (via parselmouth) for voice‑quality metrics like HNR, jitter, shimmer, and formants. A heuristic attractiveness/comfort score (0‑100) and analysis confidence score are generated. Output includes spectrogram and voice profile visualisations, a detailed text report, and structured JSON metrics.\n\n## Tech stack\n- Bash\n- Python\n- ffmpeg\n- librosa\n- praat‑parselmouth\n- pyloudnorm\n- numpy\n- matplotlib\n- FastAPI (optional)",
    "en_title": "Voice Timbre & Comfort Analysis",
    "en_description": "Analyse acoustic properties of recorded speech or any audio track, including timbre, pitch, loudness dynamics, sibilance, and listening comfort.",
    "tree_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/voice-analyze/",
    "readme_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/blob/main/tools/voice-analyze/README.md"
  }
]