Continue Watching
Automatically track your viewing progress and resume where you left off:Progress Tracking
- Automatic saving - Progress saved every few seconds during playback
- Cross-device sync - Resume on any device when signed in
- Per-episode tracking - Each TV episode maintains separate progress
- Smart resume - Automatically detects when you’ve finished watching (90% threshold)
Progress is saved both locally and to the cloud, ensuring you never lose your place.
Continue Watching Row
The Continue Watching section appears on your home screen:- Shows content with active progress
- Displays progress bars for each item
- Automatically advances to next episode for TV shows
- Removes completed content automatically
Custom Lists
Organize your content into personalized collections:Creating Lists
Adding Items to Lists
Add content to your lists in multiple ways: From Content Details:- Click on any movie or TV show
- Click the “Add to List” button
- Select which list(s) to add it to
- Search for content
- Click the menu icon on any result
- Select “Add to List”
- Open the player menu
- Click “Add to List”
- Choose your list
Managing Lists
Renaming Lists
Reordering Lists
Change the order of your lists:- Navigate to the Lists page
- Use the up/down arrows next to each list
- Lists reorder immediately
- Order is saved automatically
Deleting Lists
Deleting a list removes it from your library but doesn’t affect the actual content. You can always re-add items to new lists.
List Item Management
Removing Items
Drag and Drop Reordering
Reorganize items within a list:- Click and hold on an item
- Drag it to the desired position
- Release to drop in the new location
- Order saves automatically
List Playback
Play through list items sequentially:- Open any list
- Click on an item to start playing
- Next items in the list will be suggested when current item finishes
- Continue through your entire list in order
List playback respects your custom ordering, playing items in the sequence you arranged.
Search and Discovery
Searching Content
Raffi provides powerful search across multiple sources: Search Sources:- Cinemeta - Large database of movies and TV shows
- Addon Catalogs - Search through your configured addons
- Combined Results - Merged results from all sources
Search Features
Search Performance
- Instant results from Cinemeta database
- Addon search timeout - 1.8 seconds max per addon
- Cached results - Recent searches cached for 60 seconds
- Deduplication - Duplicate results automatically merged
Content Metadata
Each search result includes:- Title and Year
- Poster image
- IMDb ID
- Content type (Movie or Series)
- Release information
Popular Content
Discover trending content:Popular Sections
- Popular Movies - Trending films
- Popular Series - Trending TV shows
- Automatically updated - Fresh recommendations daily
Browsing Popular Content
- Navigate to the home screen
- Scroll to “Popular Movies” or “Popular Series”
- Click any title to view details
- Add to lists or start watching immediately
Local Library
Manage locally stored video files:Adding Local Files
- Click “Local Library” in the sidebar
- Click “Add Folder” or “Add Files”
- Browse to your video files
- Raffi scans and matches content to metadata
Metadata Matching
Raffi automatically identifies local files:- Extracts titles from filenames
- Matches against online databases
- Retrieves posters, descriptions, and cast information
- Organizes by detected content
Episode Management
For TV series, Raffi provides comprehensive episode tracking:Season Navigation
- View all seasons for any series
- Browse episodes within each season
- See episode titles and descriptions
- Check watched status at a glance
Episode Tracking
- Per-episode progress - Track each episode individually
- Watched indicators - Visual markers for completed episodes
- Next episode suggestions - Automatic progression to next unwatched episode
- Season completion - Track progress through entire seasons
Binge Watching Features
- Start any episode
- When it ends, next episode prompt appears
- Click to immediately start next episode
- Or wait for automatic progression (5-second countdown)
Raffi remembers your position in each series, making it easy to continue watching from where you left off.
Data Synchronization
Cloud Sync
When signed in, your library syncs across devices: Synced Data:- Custom lists and their contents
- Watch progress for all content
- List ordering and organization
- Favorite status
- Addon configuration
- Local file library
- Player settings (volume, subtitle delay)
- UI preferences
Offline Support
Your library works offline:- Access previously loaded content metadata
- View your lists and organization
- Sync changes when connection restored
- Local playback continues working
Advanced Features
Catalog Browsing
Browse content from addon catalogs:- Navigate to catalogs section
- Select an addon catalog
- Browse by genre, popularity, or other filters
- Click any item to view details
Metadata Caching
Raffi caches content metadata for performance:- Faster load times for previously viewed content
- Reduced network requests
- Offline access to cached data
- Automatic cache invalidation for freshness
Multi-source Aggregation
Content information comes from multiple sources:- Cinemeta - Primary metadata source
- Addon metadata - Additional information from addons
- Fallback logic - Uses best available source for each field
For non-IMDb content IDs, Raffi prioritizes addon metadata over Cinemeta.
Best Practices
Organize with Lists
Create specific lists for different purposes: watchlist, favorites, genres, etc.
Regular Cleanup
Periodically remove completed content from lists to keep them manageable.
Use Search Effectively
Search by title and year for more accurate results.
Track Progress
Let Raffi track your progress automatically - don’t manually mark as watched.