[
  {
    "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\nA Python tool that resolves an aircraft's 24-bit ICAO address (Mode S hex) to its registration and country. It uses three strategies: an algorithmic decoder for countries with embedded registrations (Turkey, USA, Russia), a tie-up database of over 516,000 known hex→registration mappings, and a range lookup that identifies the country from ICAO24 blocks. The tool also provides confidence scoring and batch analysis.\n\n## Tech stack\n- Python 3.10+ (standard library only)\n- CSV database (516K+ records)\n- JSON output",
    "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\nfind-and-rename is a Bash script that performs bulk replacement of file paths across specified directories. It supports dry-run mode to preview changes before applying them, making it suitable for tasks like user migration in shared environments.\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 runs FIO benchmarks to measure IOPS across multiple block sizes (4K–128K) and access modes (randread, randwrite, read, write). Results are saved as JSON and text reports, with an optional cleanup of the test file.\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\nThis Bash script provides a read-only audit of macOS disk usage, helping users identify what is consuming space on their MacBook. It reports APFS disk usage, large directories, known cleanup candidates, media sizes, Docker usage, and more, without deleting anything.\n\n## Tech stack\n- Bash\n- Markdown",
    "en_title": "macos-disk-cleaner",
    "en_description": "Read-only macOS disk usage audit to find cleanup candidates.",
    "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 set of scripts and configuration files to set up a distributed MinIO S3 storage cluster managed by systemd. Includes a main deployment script that handles service lifecycle, environment variable configuration, and optional Docker-based deployment with HAProxy load balancing.\n\n## Tech stack\n- Bash\n- Systemd\n- MinIO\n- Docker (optional)\n- HAProxy (optional)",
    "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 structured Markdown, including an indented task tree, an ASCII Gantt chart (configurable by day/week/month), a task table with dates and progress, and a dependencies table. It wraps Python and Java libraries (MPXJ) for reliable parsing, with an optional shell wrapper to automate dependency setup.\n\n## Tech stack\n- Bash\n- Python\n- Java\n- MPXJ\n- Markdown",
    "en_title": "MPP → 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 capture a health snapshot combining NVMe SMART data with Btrfs device statistics, optionally sending desktop notifications via notify-send, and providing detailed Btrfs analysis for chunks, profiles, and per-device usage.\n\n## Tech stack\n- Bash\n- Btrfs (btrfs-progs)\n- smartmontools\n- notify-send (optional)",
    "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\nProvides a minimal Docker Compose setup for a single-node OpenSearch instance (version 2.11.0) without SSL, intended for local development and testing.\n\n## Tech stack\n- Docker\n- Docker Compose\n- OpenSearch",
    "en_title": "OpenSearch Docker Compose",
    "en_description": "A quick-start single-node OpenSearch cluster using Docker Compose for local development.",
    "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 Host & Cluster Configuration Optimizer",
    "en_description": "A suite of Python scripts to analyze and optimize Proxmox VE 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 lightweight script for cleaning up media libraries. It scans a given base directory for subdirectories that no longer contain any video files, then removes them. Designed to be run on a schedule via cron, with dry-run and logging options to prevent accidental deletions.\n\n## Tech stack\n- Bash 4+\n- Standard Unix utilities (find, rm)",
    "en_title": "Purge Stale Video Dirs",
    "en_description": "A cron-ready Bash script that removes empty video directories by checking for missing 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\nA Bash script that renames Skyrim save files (.ess, .skse) by replacing Cyrillic letters with their Latin equivalents using a transliteration table.\n\n## Tech stack\n- Bash\n- sed",
    "en_title": "Skyrim Save Rename",
    "en_description": "Renames Skyrim saves by transliterating Cyrillic characters to Latin in filenames.",
    "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": "ssh-nope-shell",
    "title": "SSH refusal shell",
    "description": "An SSH honeypot / prank service that accepts any username and password, then drops the visitor into a fake shell that never grants real system access.",
    "languages": [
      "Bash",
      "Config",
      "Markdown",
      "Python",
      "Text"
    ],
    "detail_url": "https://tools.nyan404.ru/tools/ssh-nope-shell/",
    "external_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/ssh-nope-shell/",
    "detail_content": "## Overview\nAn SSH honeypot / prank service that accepts any username and password, then drops the visitor into a fake shell that never grants real system access.\n\n## Tech stack\n- Bash\n- Config\n- Markdown\n- Python\n- Text\n",
    "en_title": "SSH refusal shell",
    "en_description": "An SSH honeypot / prank service that accepts any username and password, then drops the visitor into a fake shell that never grants real system access.",
    "tree_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/ssh-nope-shell/",
    "readme_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/blob/main/tools/ssh-nope-shell/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 tracks CPU, memory, disk, and swap usage, sending alerts via Telegram Bot API when configurable thresholds are exceeded. It uses only standard Python libraries and includes a fallback mode for containers.\n\n## Tech stack  \n- Python  \n- Bash  \n- systemd  \n- Telegram Bot API",
    "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\nthrottle-detect is a Bash script that monitors CPU frequency using turbostat and alerts when the frequency drops below a user-specified threshold, indicating potential CPU throttling.\n\n## Tech stack\n- Bash\n- turbostat",
    "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 command-line work time tracker that logs clock in/out, break, and return events to weekly CSV files. Designed to be compatible with an existing legacy bash script, it provides a simple Python alternative for tracking hours.\n\n## Tech stack\n- Python\n- CSV",
    "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"
  },
  {
    "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 acoustic features from speech or any audio track, including spectral properties, pitch, loudness dynamics, and sibilance. It classifies timbre (dark/balanced/bright), estimates voice quality using Praat metrics (HNR, jitter, shimmer, formants), and produces heuristic attractiveness/comfort and confidence scores. Outputs include spectrograms, voice profile visualizations, a detailed text report, and structured machine-readable metrics.\n\n## Tech stack\n- Python\n- Bash\n- librosa\n- praat-parselmouth\n- pyloudnorm\n- numpy\n- matplotlib\n- ffmpeg",
    "en_title": "Voice Timbre & Comfort Analysis",
    "en_description": "Analyzes recorded speech or audio tracks for timbre, pitch, loudness, 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"
  },
  {
    "name": "voice-transcribe",
    "title": "remote Russian voice note transcription",
    "description": "Sends a local .ogg voice note to nyan404@192.168.15.193, runs Whisper on that machine, and downloads the resulting .txt transcript back to the local machine.",
    "languages": [
      "Bash",
      "Markdown",
      "Python",
      "Text"
    ],
    "detail_url": "https://tools.nyan404.ru/tools/voice-transcribe/",
    "external_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/voice-transcribe/",
    "detail_content": "## Overview\nThis tool transcribes Russian voice notes by sending local audio files (OGG, WAV, MP3, etc.) to a remote machine over SSH/SCP. On the remote host, it sets up a Python environment and runs Whisper with Russian language settings, then downloads the plain-text transcript back to the local machine. An optional Ollama pass can clean up punctuation and casing.\n\n## Tech stack\n- Bash (client script and remote bootstrapper)\n- Python (remote transcription engine)\n- Whisper / faster-whisper (speech-to-text)\n- SSH/SCP (file transfer and remote execution)\n- Ollama (optional text cleanup)",
    "en_title": "Remote Russian Voice Note Transcription",
    "en_description": "Uploads an audio file to a remote server via SSH, transcribes it with Whisper (Russian default), and downloads the resulting text transcript.",
    "tree_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/tree/main/tools/voice-transcribe/",
    "readme_url": "https://git.nyan404.ru/nyan404/helpfull-tools/-/blob/main/tools/voice-transcribe/README.md"
  }
]