Adding Media Libraries

Overview

Media libraries are how Norri organizes your content. Each library is associated with one or more folders on your system and a specific content type.

Library Types

Norri supports five library types: Movies, TV Shows, Music, Photos, and Home Videos.

Adding a Library

1. Go to Settings → Libraries
2. Click Add Library
3. Select the library type
4. Enter or browse to the folder containing your media
5. Click Save

Local Folders

For media stored directly on your server, use the Browse button to navigate to your media folder, or type the path directly (e.g., /mnt/media/movies).

Network Storage (NAS)

For media on a NAS or network share, you can enter a network path directly:

• \\nas\movies. UNC format
• smb://192.168.1.100/media. SMB URL format

If the share requires a password, expand Network Credentials and enter your username and password. For guest/anonymous shares, leave credentials empty.

You can also use the Network tab in the directory browser to discover available shares on your network.

Media Organization

For best results, organize your media following these naming conventions:

Movies

Movies/
├── Movie Name (2023)/
│   └── Movie Name (2023).mkv

TV Shows

TV Shows/
├── Show Name/
│   ├── Season 01/
│   │   ├── Show Name - S01E01 - Episode Title.mkv
│   │   └── Show Name - S01E02 - Episode Title.mkv

See Media Organization for complete details.

Scanning Libraries

After adding a library, Norri scans the folders to discover your media. You can also manually trigger a scan from the library’s edit page.

Maintenance Operations

Four operations are available from each library’s settings page:

• Library Scan discovers new files, removes deleted ones, and matches new media to metadata sources
• Update Metadata fetches updated metadata for items that have recently changed
• Replace Metadata re-downloads all metadata for every item in the library
• Analyse Files re-reads media files to update codec, resolution, and other technical information

See Library Maintenance for full details on each operation, including automatic scheduling and keyframe extraction.

Sorting

Movies and TV shows are sorted by their sort title, which is generated automatically when an item is added to your library. The sort title strips common leading articles like “The”, “A”, and “An” so that “The Matrix” appears under M rather than T.

You can edit the sort title for any movie or TV show from its edit page. Go to the item’s detail page, click Edit, and change the Sort Title field. Your custom sort title is preserved across library scans and metadata updates.

This is useful when the automatic sort title doesn’t produce the order you want. For example, you might want a franchise to sort together, or a numbered sequel to appear in the right position.

Unavailable Files (Trash)

When Norri scans a library and can’t find a file that was previously there, it doesn’t delete the record immediately. Instead, the file is marked as “unavailable” and moved to the library’s trash.

This protects you from losing your library data when:

• A network drive is temporarily offline
• An external drive is disconnected
• Files are accidentally deleted but you have a backup

Viewing Trash

1. Go to Settings → Libraries
2. Click Edit on the library
3. Scroll down to the Unavailable Files section

You’ll see counts of:

• Unavailable: files not found during the last scan
• Pending Removal: files scheduled for permanent deletion

Emptying Trash Manually

To permanently remove unavailable files from the database:

1. Go to the library’s edit page
2. In the Unavailable Files section, click Empty Trash
3. Confirm the action

Automatic Trash Emptying

You can configure Norri to automatically empty trash after each scan, similar to Plex:

1. Go to the library’s edit page
2. Enable Empty trash automatically after every scan
3. Optionally set a Grace Period (days to wait before removing)

Default behavior (grace period = 0): Files are removed immediately when not found during a scan. This matches Plex’s default behavior.

With grace period: Files must be missing for the specified number of days before they’re removed. Use this if you want time to restore accidentally deleted files.

Network Storage Safety

Norri includes protection for network storage users:

• If a drive/share is offline: Norri skips that path entirely and makes no changes
• Files are only removed when: The path is confirmed accessible AND the file is genuinely missing

You’ll never lose your entire library because a NAS was temporarily offline during a scan.

Library Settings

Localization

Each library can have its own language and country settings:

Metadata Language

Sets the language for titles, descriptions, and taglines fetched from TMDB.

• en. English (default)
• de. German
• fr. French
• etc.

When set, Norri will:

• Search TMDB using your preferred language
• Download titles and overviews in that language
• Prefer posters, backdrops, and logos in that language (when available)
• Fall back to English artwork if your language isn’t available on TMDB

For example, a German user with de will see “Die Verurteilten” instead of “The Shawshank Redemption” if a German title exists on TMDB.

Rating Country

Sets which country’s age ratings to display:

• US. MPAA ratings (G, PG, PG-13, R, NC-17)
• GB. BBFC ratings (U, PG, 12A, 15, 18)
• DE. FSK ratings (FSK 0, 6, 12, 16, 18)
• etc.

If a rating isn’t available for your country, Norri can estimate one based on ratings from other countries. This can be enabled/disabled in library settings.

Artwork Management

Each movie and TV show has three artwork types: poster, backdrop, and logo. You can manage these from the item’s edit page (Settings → Libraries → click an item → Edit).

Changing artwork:

• Click Change Poster, Change Backdrop, or Change Logo to open the artwork picker
• Upload your own image (JPG, PNG, or WebP, max 10MB)
• Fetch from TMDB to browse all available options from TMDB’s database

Locking artwork:

• Click the lock icon next to any artwork type to prevent automatic updates from overwriting it
• Locked artwork is preserved during all scans and refreshes (including Full Refresh)
• Unlock at any time to allow automatic updates again

Logo settings:

• Use logos toggles whether logos are downloaded and displayed. When disabled, the text title is always shown instead. Enabled by default.
• Fall back to English logos controls whether English logos are used when no logo is available in your library’s language. Enabled by default. This setting only appears when the library language is not English.

Original Title Display

When a movie or TV show has a different original title from the one in your library’s language, Norri displays the original title underneath. For example, if your library is set to English and you have the French film “The Infallibles”, you’ll see the English title prominently displayed with the original French title “Les Infaillibles” shown below it.

This is useful for:

• Identifying foreign films by their original release title
• Distinguishing between films with similar translated titles
• Quickly seeing whether a film was originally produced in another language

The original title appears automatically whenever it differs from the localized title. No configuration needed.

NFO Files

• Read NFO files to import metadata from existing .nfo files (Kodi format)
• Write NFO files to export metadata for use with other software