NZB Flow

A powerful GUI application to automate usenet posting. Built with modern web technologies, it orchestrates external CLI tools for the complete posting workflow: rar for compression, parpar for par2 creation, and nyuu for posting.

Quick Start

Download

📥 Download Latest Release

Prerequisites

The application requires access to three external CLI commands:

• RAR: Automatically detects WinRAR installation on Windows
• ParPar & Nyuu: Built-in installation option through Node.js

Setup

1. Configure Servers: Set up your usenet server settings in the main settings screen
2. Multiple Servers: Full support with profile linking
3. Default Profile: Comes with sensible defaults for posting
4. Start Posting: Simply drag and drop files to begin

📚 Check out the profile settings docs for detailed and advanced posting settings.

Features

🎯 Core Functionality

• Easy drag and drop interface
• Smart queue system: Separate queues for compression/par2 creation and uploading
• Profile-based settings for different posting scenarios
• Folder monitoring with profile assignment
• Approval system for upload tasks (optional)

🔐 Security & Obfuscation

• Complete obfuscation capabilities:
  • Random file names
  • Random archive passwords with encrypted headers
  • Subject obfuscation
  • YENC name obfuscation
  • Filename metadata obfuscation
  • Fully customizable nyuu templates

⚙️ Advanced Options

• RAR Configuration:
  • Preserve folder structure
  • Custom volume sizes
  • Solid archive support
  • File exclusion patterns
  • Option to disable RAR completely
• ParPar Options: Advanced redundancy and slice settings
• Nyuu Customization: Post checks, retry attempts, and comprehensive CLI options
• Custom CLI Arguments for all external tools

🌐 Automation & Integration

• Optional API server for remote control
• WebSocket server for real-time updates
• Automatic updates (configurable)
• Automatic file generation (.txt, .nfo, etc.) per post

Documentation

Topic	Description
📁 Profile Settings	Comprehensive guide to posting profiles and all available options
📅 Queue System	Details about the dual-queue architecture and settings
🌐 API Server	Remote control API with Postman collection
🔌 WebSocket Server	Real-time event system documentation
📝 Content Templates	File generation and templating system

Configuration

Replace Existing Files

Under General Settings, the “Replace existing files” option controls conflict resolution:

• ✅ Enabled: Deletes existing files (rar/par folders, NZB files) before starting new jobs
• ❌ Disabled: Automatically renames tasks (e.g., “post-name-1”, “post-name-2”) to avoid conflicts

⚠️ Note: Disabling this option will also alter the post name to match the renamed task.

External Tool Documentation

Tool	Documentation Link
RAR CLI	Complete Command Reference
ParPar CLI	Full Help Documentation
Nyuu CLI	Complete Usage Guide

Troubleshooting

Common Issues

Special Characters in Post Names

⚠️ Important: Avoid special characters in post names as they can cause file creation errors.

Use only alphanumeric characters, spaces, hyphens, and underscores for reliable operation.

---

Development

Project Status

NZB Flow is an active passion project focused on providing a robust usenet posting solution. While built on Electron (for UI familiarity), all core operations use native CLI executables for optimal performance.

Current Focus Areas:

• Performance testing and optimization
• UI/UX improvements for better table layouts
• Enhanced mobile responsiveness

Planned Features:

• 🔄 Backup server support per profile with automatic failover
• 🎨 Visual improvements for better wide-screen layouts
• 📦 More compression format support

💬 Suggest Features: Have ideas? Open an issue on GitHub!

Build From Source

Prerequisites: Node.js and pnpm

Install Dependencies

pnpm install

Build for Production

# Windows
pnpm build:win

# macOS
pnpm build:mac

# Linux
pnpm build:linux

Development Mode

pnpm dev

---

Repository: github.com/db1996/nzb-flow License: View License