Skip to content

Usenet Setup

This guide walks you through setting up StremThru's Usenet support end-to-end - from adding your Usenet provider and Newznab indexers to streaming content in Stremio.

Prerequisites

Before you begin, make sure you have:

  • StremThru running with Vault
  • Usenet Provider - you'll need access to NNTP server
  • Newznab Indexer - you'll need access to Newznab indexer

INFO

Vault is required for Usenet functionality.

Step 1: Add Usenet Servers

Navigate to Dashboard > Usenet > Servers and click Add Server.

Fill in the server details:

FieldDescription
NameA label for this server (e.g. My Provider)
HostThe NNTP server hostname (e.g. news.provider.com)
PortThe NNTP port (typically 119 for plain or 563 for TLS)
TLSEnable for encrypted connections (recommended)
UsernameYour Usenet provider account username
PasswordYour Usenet provider account password
PriorityLower numbers are tried first when multiple servers are configured
BackupMark as backup, used only when article missing on primary servers
Max ConnectionsMaximum simultaneous NNTP connections allowed for this server

Click Test Connection to verify the credentials and connectivity, then click Save.

TIP

Add your preferred provider with a low priority number (e.g. 0). If you have a provider with block account, add it as Backup.

Step 2: Add Newznab Indexers

Navigate to Dashboard > Usenet > Indexers and click Add Indexer.

Fill in the indexer details:

FieldDescription
NameA label for this indexer (e.g. My Indexer)
URLThe base URL of the Newznab-compatible indexer
API KeyYour indexer API key
Rate LimitOptional - limit requests per time period to avoid hitting indexer caps

Click Save to add the indexer.

TIP

You can add multiple indexers. Results from all enabled indexers are aggregated when searching for content.

Step 3: Install the Newz Stremio Addon

Navigate to Stremio Addons > Newz in your StremThru instance. Configure the options as needed, then click the install button to add the addon to Stremio.

Indexer controls where NZBs are searched:

ValueDescription
StremThruCombines results from the Newznab indexers configured in the dashboard
GenericUses a Newznab-compatible indexer directly - provide the URL and API key
TorboxUses Torbox's built-in indexer - only usable with the Torbox store

Store controls how content is downloaded and streamed:

ValueDescription
StremThruStreams using your configured Usenet servers and any stores in STREMTHRU_STORE_AUTH
TorBoxUses TorBox for downloading and streaming

INFO

When using the StremThru indexer or store, Usenet server or Newznab indexer must be configured in dashboard. The Torbox indexer and store can work independently without those.

Verifying the Setup

  • Check pool status - navigate to Dashboard > Usenet > Config to see the status of your configured Usenet servers and verify connections are healthy.