1. Sidebar (Navigation Panel)

The Sidebar is the permanent navigation bar on the left side of the application, featuring a dark mode design.

1.1 Logo

The Zenith logo is displayed at the very top of the sidebar (Arrow + Mountain + "ZENITH" lettering). The logo serves as visual brand identification.

1.2 Navigation Menu

Below the logo is the vertical navigation list. The entries are divided into logical groups, separated by invisible spacers:

Main Areas

Connection

Automation

Notifications

System

Active State Styling

• Selected: Cyan text color with a left cyan border and a dark background
• Hover: Slightly brightened text color
• Normal: Muted violet-gray

1.3 Admin Lock (🔓 Admin)

The Admin Lock button is located at the bottom edge of the sidebar. This allows an administrator to lock specific tabs with a password to prevent unauthorized modifications.

Locked tabs are marked with a 🔒 symbol and can only be accessed after entering the admin password.

1.4 Demo Notice

In DEMO mode, an orange warning box is displayed at the bottom of the sidebar:

⚠ DEMO VERSION
Restricted functions
Upgrade for full access

2. Dashboard (Command Center)

The Dashboard is the home page of the application, providing an at-a-glance overview of all critical systems. It is scrollable and automatically updates every 3 seconds.

2.1 VPN Status Card (Full Width, Top)

The VPN card displays the current connection status and allows toggling the VPN on/off directly from the dashboard.

Elements

States

Behavior

• Upon activation, it first checks if a VPN interface is configured.
• In case of an error, the toggle automatically resets.
• The status synchronizes automatically with the VPN Guard tab.

2.2 Queue Card (Left, Main Area)

The Queue Card occupies the largest portion of the dashboard and features two sub-tabs: Upload and Download.

2.2.1 Upload Page

Displays all upload tasks in the queue as a scrollable list.

Task Entries

Each task is shown as a row containing the following info: - Task name (e.g., rudirudi5 (7th Copy)) - File size (e.g., 656.9 MB) - Status (Pending / Packing / Uploading / Completed / Failed / Paused) - Progress bar (0–100%) - Speed (for active uploads)

Clicking a row selects the task (highlighted in blue), allowing it to be started individually.

Buttons

3-State Logic: The main button cycles between "Start All" → "Pause All" → "Resume All", identical to the Download tab.

2.2.2 Download Page

Displays all download tasks (NZB imports) in the queue.

2.3 Watched Folders (Top Right)

Displays all configured monitored folders (Watchfolders) with individual toggle switches.

Behavior - Deactivating: Removes all pending tasks of this folder from the queue. - Activating: Restarts the watchdog and scans the folder for existing files. - Folders are added/removed via Settings → Watched Folders. - If no folders are configured: "No watchfolders configured".

2.4 Disk Space Guard (Bottom Right)

Displays current storage consumption and contains several sub-sections.

2.4.1 Disk Usage

2.4.2 Cache

2.4.3 RAM Mode

Below a purple divider line is the RAM Mode indicator:

RAM Mode: When enabled, upload tasks are processed in RAM (tmpfs under /dev/shm) instead of on the hard drive. This speeds up packing and PAR2 operations significantly but requires sufficient free memory.

2.4.4 Speedtest

2.5 Title Bar (Custom)

Zenith uses its own frameless window title bar at the top edge:

2.6 Status Bar (Bottom)

At the bottom edge of the window is the permanent status bar:

2.7 System Tray Icon

Zenith shows a system tray icon in the taskbar (next to the clock): - Right-click: Context menu with Show/Hide, Pause/Resume, Quit - Left-click: Show/hide window - When the "Minimize to Tray" option is enabled, closing the window only hides it.

2.8 Ad Banner (DEMO only)

In DEMO mode, a rotating ad banner is displayed above the content area (across all tabs): - Rotates every 15 seconds - Displays upgrade offers and partner advertisements - Disappears after license activation

Upload Tab — Upload Queue

The Upload tab is the central hub for managing all upload tasks. Here, files and folders are added, the upload process is controlled, and progress is monitored.

1. Page Overview

The tab is vertically split into the following areas: - Header — Title and description - Control Bar — Button to add files - Drag & Drop Zone — Drop files via mouse - Upload Queue — Interactive table with all tasks - Upload Log — Real-time activity protocol

2. Header

3. Control Bar

➕ Add Upload ▾ (Dropdown Button)

A primary button with a dropdown menu offering two options:

Added files/folders are queued immediately.

4. Drag & Drop Zone

Below the control bar is a dashed drop zone:

📥 Drag and drop files or folders here to upload

Behavior - Normal: Dashed gray border - On Drag Hover: Border changes to Cyan with a slight background glow - After Drop: Files are automatically added to the queue - Supports files and folders simultaneously - Multiple files can be dropped at once

5. Upload Queue (Main Area)

The queue is an interactive table housed inside a dark card with rounded corners.

5.1 Queue Header

5.2 Table Columns

5.3 Status Values

5.4 Action Buttons (Per Row)

Each row features three small buttons on the right:

Glow Logic - Active Task (Packing/Uploading): Play button glows green - Paused Task: Pause button glows orange - Completed/Failed Task: No glow, buttons remain neutral - Pending: All buttons neutral (gray)

5.5 Neon Progress Bar

The progress bar is a custom widget (NeonProgressBar) featuring: - Color gradient from Dark Blue to Cyan to Bright Blue - Glow effect at the leading edge of progress - Percentage displayed as overlay text

6. Global Control Buttons (Below Table)

Graceful Pause: When pausing, the current processing step (e.g., packing or uploading) is completed before the task halts. Active NNTP connections are not abruptly severed.

Automated Removal

If "Automatically remove completed uploads" is enabled in settings: - The "✓ Hide Completed" button is grayed out and disabled. - Tooltip displays: "Automated removal is enabled". - Completed tasks are automatically removed from the table after 5 seconds.

7. Upload Log

At the bottom edge of the tab is a real-time protocol log inside its own card:

Appearance - Background: Dark terminal design with monospace font - Auto-Scroll: Automatically jumps to the newest entry

Color Coding

Log Entry Prefixes - 📎 File added to queue - 📦 Task is packing (7-Zip) - 🛡 PAR2 creation running - ⬆ Upload in progress - ✅ Task completed - ❌ Task failed - ⚠ Warning (e.g., no selection) - ▶ Queue started/resumed - ⏸ Queue paused - 🗑 Task removed - ✓ Completed entries removed

8. Pipeline Processing

The background upload engine works in a pipelined mode:

While Task A is uploading, Task B can already begin packing.

• DiskGuard prevents too many tasks from packing simultaneously (storage control).
• ConnectionBudget manages NNTP connections shared between upload and download tasks.

9. Single-Task Mode

By clicking the ▶ button on an individual task or via the "▶ Start Single" button in the dashboard, an isolated task can be launched:

• Only the selected task is processed.
• The remaining queue stays paused.
• Upon completion of the single task, the queue automatically returns to a paused state.
• Useful for testing or high-priority uploads.

Download Tab — Usenet Downloader

The Download tab enables downloading files from Usenet via NZB files. It supports multi-connection downloads, automatic password detection, PAR2 repair, 7-Zip extraction, and NZBLNK protocol handling.

1. Page Overview

The tab is vertically split into the following sections: - Header — Title and description - NZB Import Card — NZB file/URL entry, password, queue button - Download Queue — Table with all download tasks - Download Log — Real-time activity log

2. Header

3. NZB Import Card

A rounded card housing the import widget to add new downloads.

3.1 Drag & Drop Zone

📎 Drag & Drop NZB file here

• Normal: Dashed gray border
• On Drag Hover: Text changes to "📥 Drop NZB here!", border turns Cyan
• Accepts .nzb files exclusively

3.2 NZB Input Field

Supported Inputs - Local File: /home/user/downloads/example.nzb - URL: https://example.com/releases/example.nzb — downloaded automatically - Clipboard: NZB URLs and NZBLNK links are auto-detected from the clipboard

3.3 Password Field

Automatic Password Detection

The system automatically extracts passwords from the NZB filename using common formats: - filename {{password}}.nzb - filename [password].nzb - filename - password.nzb

Upon detection, the password field is auto-populated and logged: 🔑 Password detected: p*****d

3.4 Action Button

➕ Add to Queue: Adds the NZB file to the download queue. Only becomes active when a valid NZB file/URL is provided.

Note: This button only queues the task; it does not start the download automatically. Execution is handled via the separate Start button.

4. Download Queue

4.1 Queue Header

4.2 Table

Identical column structure to the Upload Queue:

4.3 Status Values

4.4 Right-Click Context Menu

Right-clicking a queue entry reveals a context menu: - 🔑 Set/Change Password: Opens a dialog to enter or modify the password for this download.

5. Control Buttons

6. Download Log

Real-time log tracking identical to the Upload tab: - Background: Terminal design with monospace font - Color Coding: Green (Success), Red (Error), Gray (Info)

Typical Log Entries - 📎 NZB added to queue - 📥 Downloading NZB from URL - 📋 NZB link detected from clipboard - 🔑 Password detected or set - 🔍 Searching Binsearch/NZBIndex/Newznab - ⬇ Download in progress (progress tracking) - 🛡 PAR2 repair - 📦 Extraction - ✅ Download completed - ❌ Download failed - ⏸ Download(s) paused - ▶ Download(s) resumed/started

7. Special Features

7.1 Clipboard Monitoring

Zenith automatically monitors the clipboard for: - NZB URLs: Links containing .nzb are automatically loaded into the input field. - NZBLNK Links: nzblnk: protocol links are processed automatically.

This feature can be turned off in settings (dl_clipboard_monitor).

7.2 NZBLNK Protocol Support

Zenith registers as a handler for the nzblnk: URI scheme. Clicking an NZBLNK link in a browser will: 1. Open Zenith (or bring the existing window to the foreground). 2. Process the link automatically. 3. Search for the NZB across the following sources (in order): - Newznab indexers (if configured) - Binsearch.info (free, no API key required) - NZBIndex.com (free, RSS feed) 4. If found, the NZB is downloaded and added to the queue. 5. The password embedded in the NZBLNK is automatically applied.

7.3 Automatic Password Detection

The system extracts passwords from: - NZB Filename: Common patterns like {{password}}, [password] - NZBLNK Data: Password field inside the NZBLNK URI - Manual: Right-click → Set Password

7.4 Auto-Extraction

Following download completion, the system automatically runs: 1. PAR2 Repair: Repairs missing/corrupt segments if needed (configurable). 2. CRC Check: Verifies download integrity (configurable). 3. 7-Zip Extraction: Unpacks archives (configurable). 4. Archive Cleanup: Deletes RAR/7z files post-extraction (configurable). 5. Junk Cleanup: Deletes unneeded files like NFO, TXT, etc. (configurable).

7.5 Mirror Mode

Mirror Mode automates re-uploading after downloading:

Download → Extraction → Automated Upload via identical configuration

Status shifts to Mirror: Uploading. Controlled via the Remote Input tab or API.

7.6 Queue Persistence

The download queue saves automatically and restores upon application restart. Pending tasks survive app closures.

7.7 ConnectionBudget

Downloads and uploads split NNTP connections dynamically via the ConnectionBudget system: - If an upload runs, connections available for downloads scale back. - The Provider Usage Mode (Upload / Download / Both) dictates allocation. - If provider usage is locked to "Download", only download connections deploy.

8. Configurable Settings

The following choices can be customized under Settings → Download:

Cloud Backup — Encrypted Usenet Backup

The Cloud Backup tab provides tools to encrypt folders using AES-256, upload them to Usenet, and recover them later. The resulting NZB file acts as the decryption and restoration "key" — viable as long as the Usenet retention window remains open.

1. Page Overview

The tab layout features five distinct card modules: - 📁 Backup Sources — Manage folders - 🔐 Encryption & Settings — Passwords and configurations - 📋 Backup History — Archive log tracking - 📥 Restoration — NZB-driven data recovery - 📋 Backup Log — Real-time logging console

2. Backup Sources (Card 1)

2.1 Folder List

Each folder entry features a dedicated row containing:

2.2 Per-Folder Settings (Collapsible)

2.3 Change Detection

Zenith monitors backup paths every 5 minutes for modifications: - Tracks new, altered, or wiped files. - Status transitions to orange: ⚠ 3 Folders with localized tooltip data. - Successful backups clear the state back to green.

2.4 Buttons

• ➕ Add Folder: Opens directory picker to append a new backup root source.
• ▶ Start Backup Now: Instantly triggers an archival run across all checked rows.

3. Encryption & Settings (Card 2)

3.1 Left Side — Password

⚠ Critical: Lose the password, lose the backup. There is no password recovery or backdoor mechanism.

3.2 Right Side — Global Settings

4. Backup History (Card 3)

A log tracking historical archives:

5. Restoration (Card 4)

Recovering data requires three inputs:

Restoration Workflow: Download (Encrypted Archives via Provider) → PAR2 Repair (20% Redundancy Checks) → Decryption (7-Zip Unpacking) → Restored Files (Target Output Verified)

Button → 📥 Restore: Commences the retrieval pipeline.

6. Backup Log (Card 5)

Matches the logger implementation found in the main upload/download modules: - Terminal monospace aesthetics. - Color coding: Green (Success), Red (Failure), Gray (Info).

Log Prefixes - 📁 Backup path registered - 🔐 Encryption active - ✅ Crypto / Upload / Download task finished - 🛡 PAR2 generation processing (20% redundancy) - 📤 Uploading archive chunks - 📥 Pulling archive chunks (Restoration) - ⏰ Operational scheduling updated - ⚠ Retention threshold reached / Critical anomaly triggered - 🗑 Backup source purged

7. Automation Features

7.1 Scheduled Backups

• Scheduling scans repeat every 60 seconds.
• Tasks fire only if elapsed delta time outdates the specified interval.

7.2 Retention Warning

• Scans run every 2 hours + initially 5 seconds post-boot.
• Alerts prompt 30 days ahead of maximum retention dates.
• Alert actions recycle every 2 days until addressed or muted.

7.3 Change Detection

• Scans iterate every 5 minutes + initially 10 seconds post-boot.
• Compares file modification attributes against the previous run matrix.
• Highlights changed directories inside status tooltips via orange indicators.

8. Backup Process (Technical Specification)

8.1 Encryption Parameters

• Algorithm: AES-256 (via 7-Zip -p flag syntax).
• Header Obfuscation: Enabled (-mhe=on) — blanks internal directory names.
• Split Thresholds: Scalable volumes (10–2000 MB options).
• PAR2 Redundancy: Absolute 20% floor layout ensures payload resiliency.

8.2 Backup Modes

Statistics Tab — Upload & Download Statistics

The Statistics tab displays an overview of all upload and download histories, rendering data via interactive charts, metrics cards, and historical lists. Data is polled directly from a local SQLite engine every 5 seconds.

1. Page Overview

• Header with Timeframe Filters
• Upload Metrics — 6 analytical monitoring blocks
• Upload Volume Charts — Custom bar metrics
• Download Metrics — 6 analytical monitoring blocks
• Download Volume Charts — Custom bar metrics
• Recent Upload History List
• Recent Download History List
• Global Purge Button — Wipe statistics tables

2. Header & Timeframe Filters

Changing options filters values across metrics cards, charts, and histories.

3. Upload Metrics (⬆ UPLOADS)

Six cards span horizontally, displaying icons, titles, and data values:

4. Upload Volume Chart

A custom widget (BarChartWidget) drawn directly via QPainter: - Bars: Rounded corners running a Dark Blue to Cyan gradient fill. - Y-Axis: Dynamic scaling algorithm bounded by dashed mesh lines. - X-Axis: Timestamps scale according to active filters (DD.MM, MM, or YYYY). - Metrics: Floating values display centered above individual bars. - Empty States: Renders "No data available" fallbacks if query rows return null.

5. Download Metrics (⬇ DOWNLOADS)

Matches the upload metrics card structure, styled using a purple theme:

6. Download Volume Chart

Identical to the upload chart design, but rendered with a purple color gradient.

7. Recent Uploads (History List)

Renders the 10 most recent upload rows inside a scrollable menu list:

Status Colors: ✅ Success: Green, ❌ Failed: Red, ⏳ Pending: Yellow

Empty State Text: "No upload history available."

8. Recent Downloads (History List)

Identical layout matching the upload list structure, detailing recent downloads.

Empty State Text: "No download history available."

9. Reset Statistics

A red warning button is located at the bottom edge:

Button → 🗑 Reset Statistics: Clears database rows tracking structural metrics.

Before clearing records, the system prompts the user with an alert dialog:

Are you sure you want to reset all statistics? This action permanently clears all upload and download statistics, as well as the job history logs. This action cannot be undone.

10. Data Source Specifications

Data maps from internal tables stored at ~/.zenith-uploader/zenith.db:

Table: stats (Daily Aggregated Logs)

VPN Guard — VPN Protection for Uploads

The VPN Guard tab manages OpenVPN and WireGuard connection profiles, offering server configuration slots and custom location mapping. A built-in Kill-Switch automatically halts active queues if network tunnels drop.

1. Page Overview

• Header — Descriptive metadata
• Root Access Warning — Permissions engine tracking (Linux hosts)
• Status Card — Control toggles and network routing metrics
• Saved Profiles — Configuration profiles list
• Settings — Kill-Switch management parameters
• VPN Log — Real-time event tracking console

2. Header

3. Root Access Warning (Linux Environments)

Linux host runtimes poll environment spaces to ensure root permissions or active pkexec backends exist. Missing hooks trigger a warning banner:

⚠ Root privileges unavailable. VPN subsystems require root permissions (pkexec or sudo). Please install policykit-1 dependencies: sudo apt install policykit-1

This warning is automatically hidden on Windows platforms.

4. Status Card (Main Area)

4.1 Status Display

4.2 Connect/Disconnect Buttons

5. Saved Profiles

5.1 Profile Cards

• Country Flag: Emoji flag indicator based on geographic metadata.
• Profile Identity Name: Bold label title (e.g., "Mullvad Amsterdam").
• Detail Row: Provider name · Country destination · Protocol metadata.
• Protocol Badges: Small tags color-coded by engine types (OP = OpenVPN Green, WI = WireGuard Cyan).
• ● Selection Node: A cyan dot marks the active target profile.
• ✕ Purge Control: Circular icon button to clear profiles (glows red on hover).

Empty State View: "No profiles saved. Add a new VPN profile configuration to begin."

5.2 Add Profile Dialog (＋ Button)

Supported Countries: 🇳🇱 Netherlands, 🇩🇪 Germany, 🇺🇸 USA, 🇬🇧 UK, 🇨🇭 Switzerland, 🇸🇪 Sweden, 🇫🇷 France, 🇨🇦 Canada, 🇯🇵 Japan, 🇦🇺 Australia, 🇷🇴 Romania, 🇸🇬 Singapore, 🇪🇸 Spain, 🇮🇹 Italy, 🇳🇴 Norway, 🇫🇮 Finland, 🇦🇹 Austria, 🇧🇪 Belgium, 🇵🇱 Poland, 🇨🇿 Czech Republic, 🌍 Other.

6. Settings

Kill-Switch Parameters

If the tunnel tears unexpectedly, the master AppController catches the exception via the vpn_status_changed listener loop. It immediately pauses all active uploads, switches the display to ERROR, and logs the event. Queues must be restarted manually after establishing a safe connection path.

7. VPN Log Console

Monospace console interface with real-time log updates.

8. VPN Engine Architecture

• Active profile data loads into transient memory execution pools.
• Monitors exit codes and standard error pipes to trace active states.
• Validates connectivity paths using external IP check lookups post-handshake.
• Emits cross-module vpn_status_changed signaling to adjust dashboard widgets.

Part 7a: Remote Inputs — RSS Feeds

Remote Sources — RSS Feeds

The RSS Feed sub-tab automates polling remote indexer endpoints, scraping for target NZB releases matching defined parameters, and routing payloads directly into download task streams.

1. Structural Overview

The module uses a vertical adjustable layout: - Top Half: Interactive grid displaying all saved RSS configurations. - Bottom Half: Granular editor form fields + feed preview nodes + background logging.

2. Feed Grid Matrix (Top Section)

2.1 Table Columns

Button → ＋ Add New Feed: Injects a blank configuration row entry into the data matrix.

3. Detail Configuration Form (Bottom Section)

Selecting any row entry maps its parameters directly into the granular input form fields.

3.1 Field Mappings

3.2 Regular Expression Filter Blueprints

The dot . acts as a wildcard match character. Escape via \\. to target literal dots. Use .* for flexible character fills. Checks are case-insensitive.

3.3 Functional Actions

4. Results Preview Grid

Manual polling actions return target node arrays for validation:

Preview Controls - ☑ Select All: Checks all visible rows. - ⬇ Download Checked: Pushes selected rows into download queues. - 🗑 Dismiss Records: Removes selected records from preview tables.

Dismissed or downloaded items register their unique GUID hashes into local storage to prevent duplicates on subsequent polling iterations.

5. Background Engine Automation

When automated parsing loops run: 1. Timer Fires → Scrape API Source → Filter Out Known GUIDs → Run Regex & Size Verifications 2. If Auto-Queue Disabled: Append to Display Matrix 3. If Auto-Queue Enabled: Inject Tasks Directly

Part 7b: Remote Inputs — Newznab Indexers

Remote Sources — Newznab Indexer

The Newznab integration layer connects directly to compatible indexing endpoints via native API query routing, running custom parameter filtering protocols.

1. Overview

Matches the split layout structure used by the RSS component: - Top Half: Grid displaying active indexing engines. - Bottom Half: Profile editor fields + communication log.

2. Configuration Grid (Top Section)

Button → ＋ Add Indexer: Appends a blank indexer entry row.

3. Detail Configuration (Bottom Section)

Newznab Category Reference

Tip: Separate multiple IDs with commas. Leaving the field blank polls all categories.

4. Functional Controls

5. Background API Architecture

Newznab Endpoint Mapping: - Capability Diagnostics: GET /api?t=caps&apikey=TOKEN - Keyword Queries: GET /api?t=search&q=QUERY&apikey=TOKEN&cat=CATS&limit=LIMIT - NZB Fetching: GET /api?t=get&id=GUID&apikey=TOKEN

Processing Flow: 1. Background timer triggers execution tasks. 2. Issues HTTP GET requests with parsed categories and limits. 3. Iterates responses against active title regex matrices. 4. Drops entries failing size threshold checks. 5. Skips previously parsed items via stored GUID records. 6. If "Automated Pulls" enabled, fetches NZB and appends to active lists. 7. If "Auto-Start Engines" enabled, execution begins immediately.

6. Validated Indexer Networks

Supported systems include all standard Newznab-compliant providers: NZBGeek, DrunkenSlug, NZBFinder, NZBPlanet, DOGnzb, and Tabula Rasa.

Part 7c: Remote Inputs — FTP / SFTP

Remote Sources — FTP / SFTP

The FTP/SFTP module provides an integrated remote terminal file browser, featuring path tree navigation and background downloads to pull assets directly into localized workspace directories.

1. Structural Overview

• Top Bar: Authentication parameter forms and server access inputs.
• Main Center Body: Remote directory tree browser table showing remote filesystem structures.
• Bottom Section: Destination folder management and logging console feedback.

2. Connection Settings

2.1 Form Fields

2.2 System Actions

3. Remote Directory Tree Browser

3.1 Navigation Ribbon

• ⬆ Upper Directory: Navigates up one tier into parent folder levels.
• 🔄 Refresh Content: Re-scans active directory structures.
• Active Path Box: Monospace rendering of raw remote server path (Cyan).

3.2 Directory Content Table

3.3 Interactions

• Double-Click Directory: Enters selected child directory.
• Single-Click File: Flags rows for selection (supports multi-select).
• Click Parent Arrow (⬆): Steps backward into higher logical trees.

3.4 Library Implementations

• SFTP: Driven via paramiko. Keepalive signals every 30 seconds.
• FTP: Driven via ftplib. Passive mode enforced; UTF-8 parsing for extended character sets.

4. Download Engine

• Processes checked items sequentially through an asynchronous queue.
• Selecting a folder entity pulls its entire file tree structure recursively.

Part 8a: Auto-Post — Forum Poster

Auto-Post — Forum Poster

The Forum Poster sub-tab manages automated release indexing notifications, rendering data via template formatting engines, and pushing topics directly into targeted forum boards.

1. Overview

The UI splits into four functional layout segments: - Header Ribbon — Title + "＋ Add New Profile" trigger - Profile Selection Grid — Active destination board configurations - Posting Hold Queue — Manual approval workspace - Reference Help Card — Contextual documentation and syntax tips

2. Destination Profile Cards

2.1 Interface Components

2.2 Board Software Engine Colors

3. Profile Management Dialog

3.1 Form Fields

3.2 Thread Title Tokens

3.3 Modal Actions

• 🔌 Test Login: Probes target forum authorization without committing changes.
• ❌ Abort: Closes modal, discarding uncommitted edits.
• ✅ Commit Profile: Validates, saves, and updates lists.

4. Operational Modes

5. Manual Staging Hold Queue

Jobs under Manual mode wait inside this workspace: - 📄 Content Title: Source release filename. - → Destination: Target profile and engine version. - ▶ Post Release: Instantly processes topic submission. - 🗑 Drop Task: Purges staged notification.

Empty State: "No notifications staged inside the manual validation hold queue."

6. Engine Compatibility

Part 8b: Auto-Post — Templates

Auto-Post — Template Manager

The Templates workspace handles BBCode and HTML string formatting, letting users map dynamic tokens into target forum post payloads.

1. Overview

The interface uses a horizontal split layout: - Top Ribbon: Chip-based listing of all available token tags. - Left Pane: Listing of all saved layout definitions. - Right Canvas: Monospace text editor with format control toolbar.

2. Token Reference Chips

Tokens display inside green chips with hover tooltips detailing evaluation mechanics.

3. Left Navigation Pane

• Selection Tree: Displays templates next to a 📄 icon. Clicking populates the editor.
• ＋ New Template: Generates a new entry with boilerplate code.
• 🗑 Delete Template: Prompts verification to clear layouts.

Limits: Minimum 1 active template. Maximum 10 templates (MAX_POSTING_TEMPLATES). Auto-generates a standard template if all records are cleared.

4. Right Editing Canvas & Toolbar

4.1 Components

4.2 Toolbar Buttons

11 toolbar buttons for quick insertion of formatting tags:

Highlighting text wraps selection inside chosen tags. Clicking without selection inserts at cursor.

4.3 Save Actions

Button → 💾 Save Layout Profile: Writes names, formats, and text blocks to global config.

5. Default Boilerplate Layout (vBulletin 3.x)

[center][size=5][color=red][b]{title}[/b][/color][/size][/center]

[center][size=3][color=][b]»Content Description«[/b][/color][/size]
[size=2][color=white]{description}[/color][/size][/center]

[nfo]{nfo_content}[/nfo]

[hide]
[center][size=3][color=][b]»Usenet Release Header«[/b][/color][/size]
[size=2][color=white]{header}[/color][/size][/center]

[center][size=3][color=][b]»Archive Security Password«[/b][/color][/size]
[size=2][color=white]{password}[/color][/size][/center]

[center][nzblnk]nzblnk:?t={title}&h={header}&p={password}[/nzblnk]
[/center][/hide]

6. Rendering Engine Process

1. Pulls assigned format from active profile definitions.
2. Regex replacement loop swaps all {placeholder} tags with runtime parameters.
3. Renders thread title separately using its own formatting rules.
4. Forwards finalized text to forum poster threads.

Webhooks & Notifications

The Webhooks sub-tab hooks into API interfaces to push real-time status alerts across communication applications when milestones or warnings trip.

1. Overview

• Header: Title + "＋ Add New Webhook" trigger.
• Active Target Grid: Saved automation endpoints as selectable items.
• Reference Help Card: Payload syntax documentation.

2. Supported API Providers

3. Webhook Profile Items

Empty State: "No webhook alert paths mapped. Configure a tracking profile to receive status logs."

4. Configuration Wizard Dialog

4.1 Base Setup

4.2 Platform-Specific Fields

Discord: Target Webhook URL — Required

Telegram: Bot Token (via @BotFather) — Required; Chat ID — Required

E-Mail SMTP: Host Server, Port (587), ☑ TLS, Username, Password, Recipient — Required

ntfy: Server URL (https://ntfy.sh), Topic Channel — Required, Access Token — Optional

Custom HTTP: Destination URL — Required, HTTP Method (POST/PUT/GET), Headers (JSON)

5. Event Triggers

All events default to checked on new profiles.

6. Payload Data Switches

7. Test Pipeline

🔔 Dispatch Test Alert: Generates transient test profile, formats mock payloads customized to platform rules, transmits to target, returns confirmation popup.

Part 10a: Settings — Provider

Settings — Provider

The Provider panel houses Usenet network connection profiles, managing news server configurations and balancing outbound upload pipelines alongside inbound file retrievals.

1. Overview

• Top Area: Central grid sorting active server accounts.
• Bottom Setup Form: Profile field creation controls.
• Action Bar: Grid maintenance + connection test triggers.

2. Provider Account Matrix

3. Account Configuration Form

4. Connection Test

🔌 Verify Server Connection: Automated connectivity diagnostic:

1. Formulate account mapping → Query nntplib → Inject SSL handshake
2. Open TCP channel → Measure latency (ms) → Return welcome headers

Exceptions stop execution and redirect raw feedback to diagnostic boxes.

Part 10b: Settings — Upload

Settings — Upload Settings

The Upload Settings manager handles configuration profiles for outbound compression, metadata recovery, and execution layer optimization.

1. Overview

• Upper Ribbon: Expert Mode toggle + factory reset.
• Standard Grid: Three-column parameters for day-to-day settings.
• Expert Grid: Advanced settings in purple accent boxes (Expert Mode only).

2. Standard Settings

2.1 General Application Behavior

2.2 Processing Engine Pipeline

Pipeline Modes: Sequential completes each task before starting the next. Pipelined runs compression on upcoming jobs while uploading active payloads. DiskGuard monitors storage consumption.

2.3 Disk Guard

2.4 Cleanup Operations

2.5 Process Priority

3. Expert Settings (Purple Accent Box)

3.1 7-Zip Compression

3.2 ParPar Metadata Recovery

3.3 NNTP Network Tuning

Part 10c: Settings — Download

Settings — Download Settings

The Download Settings workspace optimizes downstream bandwidth, file system cache parameters, and multi-part archive assembly processing.

1. Overview

Five component clusters in a two-column framework: - Folders & System Workspace - Unpacking Engine Pipeline - Network Connection Parameters - Disk Guard Safeties - Mirror Mode Pipelines

2. Folders & System Workspace

3. Unpacking Engine Pipeline

Junk Extension Selector: ✅ .txt, ✅ .html, ✅ .url, ✅ .nfo, ✅ .info (Individual filters grayed out until main toggle enabled).

4. Network Connection Parameters

5. Disk Guard (Downstream)

Tip: Map downstream limits 10% lower than upload guards (e.g., Uploads 90% → Downloads 80%) to ensure download tasks never consume temporary cache headroom required for active uploads.

6. Mirror Mode

Enabling this flag clears corrupted archives from disk, preventing watchfolder scrapers from reprocessing failed packages. Disabling leaves defective data intact for manual troubleshooting.

Part 10d: Settings — Watch Folders

Settings — Watch Folders

The Watch Folders interface configures automated directory polling loops. The engine captures new files placed inside monitored locations and queues them for processing.

1. Overview

• Header Ribbon: Titles + dynamic counters (e.g., "3 / 10 Folders Monitored").
• Context Explanations: Short guides on automation rules.
• Directory Roster: Configured folders as actionable cards.
• ➕ Add Monitored Path Button: Launches directory browser.

2. Directory Monitor Cards

2.1 Interface Components

• Directory Label: Bold target folder name.
• Complete Path: Grayed out system path reference.
• Newsgroup Chips: Active index destinations as horizontal chips.
• Routing Dropdown: Combo box managing target binaries.
• ● Status: Green = active, Yellow = paused, Red = missing directory.
• ✕ Remove: Deletes monitoring configuration.

2.2 Status Verification

3. Newsgroup Category Allocations

• Supports multi-group posting rules per folder.
• Clicking chip X nodes drops newsgroup from the profile.
• "No Target Newsgroup" disables public posting for the path.
• Adding standard targets removes active __none__ restrictions.
• Unconfigured folders default to global settings.

Configuration Schema:

{
 "/home/user/Videos/Upload": ["alt.binaries.boneless", "alt.binaries.misc"],
 "/home/user/Private/Backup": ["__none__"]
}

4. Adding Watch Folders

1. Click "＋ Add Monitored Path".
2. System folder picker maps target filesystem paths.
3. Filters check against existing records to block duplicates.
4. Maximum 10 entries. Cap disables addition buttons.
5. Changes trigger automated watchdog engine reloads.

5. Removing Watch Folders

• Clicking X removes entry rows.
• Clears configuration from watch_folders files.
• Cleans up status histories in watch_folders_disabled.
• Removes records from watch_folder_newsgroups.
• Triggers live engine reloads to stop monitoring instantly.

6. Dashboard Synchronization

Toggle switches on the main dashboard write to watch_folders_disabled configuration. Components reload and sync when users navigate back to settings.

License

The License tab controls authorization activations, displays active license validity metrics, and manages device HWID allocation during equipment replacement cycles.

1. Overview

• Header — Title and scope
• License Badge — Status display banner
• Activation Card — Form inputs validating product tokens
• Licensing Utilities — 3 system operations cards
• Demo Boundaries — Visible to unauthenticated instances only
• Feature Privileges — Detailed list of unlocked premium assets

2. Licensing Tiers

3. License Badge Card

• Large badge icon reporting current state.
• Demo: "Restricted system operations — Upgrade to unlock infinite throughput."
• Full: "All premium features unlocked — Lifetime infinite tier active."
• Expiration: Reports end timestamps, ∞ Unlimited, or — (demo).

4. Registration & Key Activation

Workflow: Input Key → Execute license.activate(key) → Query Validation Endpoint → Invalid: Error dialog / Valid: Write to config → Prompt reboot.

5. Licensing Utilities

5.1 🔄 Reset Hardware Identity (HWID Reset)

Resets registration tracking hardware keys to permit migration to alternative workstations. Raises security verification alert. Dispatches license.reset_hwid.

5.2 ⛔ Deactivate Device License

Strips licensing authorizations from local equipment. Returns to Demo mode post-reboot. Crimson red button styling.

5.3 📋 Capture System HWID

Copies raw computed hardware identification hash to system clipboard via QApplication.clipboard.setText(license.hwid).

6. Demo Limitations (DEMO Only)

An amber warning banner lists restrictions: - 📦 File Cap: Maximum 1 GB per execution batch. - 📊 Queue Counter: Maximum 10 upload tasks per day. - 🏷 Branding Injection: Injects branding markers in outbound NNTP headers. - External URL: → zenith-uploader.com upgrades portal.

7. Unlocked Features (Full Version Only)

A green checklist summarizes active feature sets: - ✓ Unrestricted processing capabilities. - ✓ Anonymous outbound metadata (zero branding injections). - ✓ Dynamic performance profiles without speed limits. - ✓ Full VPN Guard & Kill-Switch controls. - ✓ High-priority customer support routing.

Support & Diagnostics

The Support tab provides real-time system performance insights, environment parsing tracking logs, and automated assistance report submission toolkits.

1. Overview

• Header — Metadata + version index tags (e.g., v1.0.0)
• System Status Roster — 4 horizontal analytical modules
• Application Log Viewer — Live console with query filtering
• Quick Assistance Actions — 4 quick-launch help cards
• Footer Links — Support mail + website routes

2. System Status Roster

3. Application Log Viewer

3.1 Toolbar

3.2 Console Parameters

• Source: ~/.zenith-uploader/logs/zenith.log
• Buffer Limit: 1000 most recent entries
• Auto-Refresh: Every 10 seconds via QTimer
• Font: JetBrains Mono 10pt (fallback: Consolas)
• Scroll: Snap-to-bottom on update

3.3 Severity Color Mapping

3.4 Console Navigation Bar

4. Quick Assistance Actions

4.1 🐛 Bug Report Compilation

• Writes log directory paths to clipboard.
• Launches file manager on support directories.
• Opens default mail client with pre-populated template.

4.2 📂 Open Log Directory

Opens ~/.zenith-uploader/logs/ in native file explorer. Auto-creates missing directories.

4.3 📋 Capture Log Path

Copies absolute filesystem path to system clipboard.

4.4 📊 Capture Environment Diagnostics

Copies formatted system info text:

Zenith Uploader — System Environment Diagnostic Data Map
======================================================
Host OS Platform: [OS]
Python Runtime Version: [Version]
Available Processor Threads: [Threads]
Memory Utilization: [Used] / [Total] GB
Log Path: [Path]

5. Footer Links

📧 [SUPPORT_EMAIL] · Documentation & Guides: zenith-uploader.com