$ show baairon/torlink
torlink is a terminal-based torrent client that combines a rich Text User Interface (TUI) with headless daemon modes for torrent search, download, seeding, and file serving. Built with TypeScript, Node.js, and React (via Ink for TUI rendering), it provides zero-configuration access to curated torrent sources across categories like games, movies, TV, and anime. The application features parallel source querying, result deduplication, automatic seeding with optional file deletion, and persistent state management for queues, history, and seeds. The architecture follows a modular design: the TUI layer (src/ui) handles interactive modes, daemon services (src/daemon) manage headless operations (serve, files, watch, seed, attach), core download logic (src/download) manages the torrent queue and engine integration, and source plugins (src/sources) fetch torrents via RSS, APIs, or web scraping. Key utilities include atomic file writes, resilient HTTP fetching, caching, and format helpers. The CLI entry point (scripts/cli-entry.cjs) handles Node version checks and WebRTC fallbacks before launching the appropriate mode. External dependencies include Ink for TUI rendering, webtorrent for torrent handling, node-datachannel for WebRTC fallbacks, and various HTTP clients. The project maintains active development with recent commits, comprehensive test coverage, and CI workflows. While dependency pinning indicates managed compatibility risks, the codebase demonstrates strong engineering practices through isolated utilities, reactive patterns for concurrent searches, and cross-platform path handling.
The LLM identified 7 files worth highlighting for reuse:
Implements atomic file writes via temporary files and renames to prevent corruption during crashes or concurrent access. Self-contained with minimal dependencies (fs, path), making it easily reusable in any Node.js application requiring safe file operations.
Provides a resilient HTTP wrapper with timeout, retry (exponential backoff), and error isolation. Dependencies are limited to an HTTP client (e.g., node-fetch), allowing extraction as a generic utility for robust external API calls in other projects.
Implements a TTL-based LRU cache with automatic eviction (100 entries, 5-minute TTL) for search results. The module is framework-agnostic, using only timers and a Map, enabling reuse as a standalone caching layer for any frequently accessed data.
Deduplicates torrent search results by info hash and merges tracker lists from multiple sources while preserving order and removing duplicates. Pure function with no UI dependencies, making it portable to other data processing pipelines requiring similarity-based merging.
React hook that cancels previous search requests when a new search is initiated, preventing stale responses and reducing unnecessary network calls. Encapsulates a common UX pattern for search inputs and can be reused in any React application with asynchronous search functionality.
Defines a theme object and provides React context for centralized theme management in Ink-based TUIs. Supports dynamic theme switching and component-level styling, offering a reusable foundation for building consistent terminal interfaces.
Centralizes keymap definitions (key combinations to actions) and provides a hook for accessing them in components. Decouples input handling from UI logic, allowing easy reuse and modification of keyboard controls across different TUI applications.