Library Overview
Your library displays all movies and TV shows you’ve added, organized by type with easy filtering and search.Key Features
Dual Library Views
Switch between Movies and TV Shows with a single tap. Each view shows a count of items in your collection.
Continue Watching
Resume playback right where you left off. The continue watching section appears at the top of your library when you have in-progress content.
Profile-Based Collections
Each profile has its own separate library. Content is isolated per profile, perfect for families or shared accounts.
Rich Metadata
Automatic TMDB integration provides posters, backdrops, descriptions, runtime, genres, and certification ratings.
Adding Media to Your Library
There are three ways to add content to your library:From Browse
The browse view shows trending and popular content from TMDB:- Navigate to the Browse tab
- Browse trending or popular content
- Click the plus icon on any movie or show
- For TV shows, select specific seasons from the context menu
From Search
Use the search feature to find specific titles:- Click the search icon
- Enter the movie or show name
- Select from search results
- Add to your library
Direct Magnet Links
You can also add content directly via magnet links if you have them from external sources.Library Organization
Movies
Movies are displayed in a grid layout with:- Movie poster
- Title and year
- MPAA rating badge (G, PG, PG-13, R, NC-17)
- Download progress indicator
- Quick actions menu
TV Shows
TV shows include additional organization:- Show poster and metadata
- Season and episode management
- Individual episode tracking
- Per-episode watch progress
- Episode file management
- Creates the show entry with TMDB metadata
- Fetches season and episode information
- Maps torrent files to episodes
- Tracks download progress per episode
TV Show Season Management
Plank intelligently handles TV show seasons:- Season Detection: Automatically detects which seasons are included in a torrent
- Episode Mapping: Maps video files to TMDB episode data
- Incremental Downloads: Add individual seasons to existing shows
- Episode Organization: Maintains proper episode order even with complex file structures
Media Status & Progress
Each media item has a status that indicates its download state:- Added: Media has been added to your library but download hasn’t started
- Downloading: Actively downloading from peers
- Complete: Fully downloaded and saved to your library directory
- Error: Download failed (usually due to no seeders)
Download Progress
While content is downloading, you’ll see:- Real-time progress percentage
- Download speed (MB/s or KB/s)
- Number of connected peers
- Estimated time remaining (in player view)
Continue Watching
Plank automatically tracks your viewing progress:- Auto-Resume: Playback resumes from where you left off
- Progress Tracking: Updated every 5 seconds during playback
- Completion Detection: Items marked complete when you watch to the end
- Recent List: Shows most recently watched items across your library
- Large backdrop thumbnails
- Watch progress bar
- Time remaining
- Quick resume playback
Library Management
Deleting Media
Remove media from your library:- Click the three-dot menu on any media card
- Select “Delete”
- Confirm the deletion
Retry Failed Downloads
If a download fails (usually due to no seeders), you can:- View the media detail page
- Click “Retry Download”
- Plank will attempt to resume the torrent
Search Your Library
Quickly find content in your library using the search feature:- Full-text search powered by SQLite FTS5
- Searches titles and descriptions
- Instant results as you type
- Fallback to fuzzy matching for partial matches
Library Storage
Completed media is stored in the library directory configured during setup:- Movies: Stored as single video files
- TV Shows: Organized by show name with season folders
- Subtitles: Stored alongside video files as .vtt sidecar files
- Metadata: Cached TMDB images stored in the library/images directory