Supported Formats
Raffi can play content from multiple sources:- Torrent/Magnet Links - Stream directly from torrents with automatic file selection
- Direct HTTP/HTTPS Streams - Play from direct video URLs
- Local Files - Browse and play videos from your computer
- HLS (HTTP Live Streaming) - Adaptive bitrate streaming with automatic quality adjustment
Video Player Features
HLS Streaming
Raffi uses HLS.js for adaptive streaming, providing smooth playback with automatic quality adjustments based on your network conditions.The player automatically detects HLS manifests (.m3u8 files) and uses optimized buffering strategies for seamless playback.
- Maximum buffer length: 50 seconds
- Back buffer: 30 seconds maintained for rewinding
- Adaptive buffering based on network conditions
Quality Selection
The player automatically selects the best quality based on your connection, but you can manually control quality through the stream selection interface:Open Stream Selection
Click the streams button in the player controls to view available quality options.
Choose Your Quality
Select from available quality options provided by your addons. Common options include 1080p, 720p, 480p, and more.
Audio Track Management
Switch between multiple audio tracks for content with different language options or audio formats:Raffi supports advanced audio codecs including EAC-3 (Dolby Digital Plus) for high-quality surround sound.
Subtitle Support
Raffi provides comprehensive subtitle support with both embedded and external subtitle sources: Subtitle Sources:- Addon Subtitles - Automatically fetched from configured Stremio addons
- Embedded Subtitles - Extracted from video files
- Local Subtitle Files - Load .srt or .vtt files from your computer
- WebVTT (.vtt)
- SubRip (.srt)
Managing Subtitles
Subtitle Delay Adjustment
If subtitles are out of sync with the audio:- Open the subtitle selection modal
- Use the delay controls to adjust timing in seconds
- Positive values delay subtitles, negative values show them earlier
- Changes apply instantly to the current playback
Playback Controls
Keyboard Shortcuts
Control playback efficiently with keyboard shortcuts:| Key | Action |
|---|---|
| Space | Play/Pause |
| Arrow Left | Seek backward 5 seconds |
| Arrow Right | Seek forward 5 seconds |
| Arrow Up | Increase volume |
| Arrow Down | Decrease volume |
| F or Escape | Toggle fullscreen |
Seek direction can be inverted based on your seek bar style preference (normal vs. Raffi style).
Seek Bar Styles
Raffi offers two seek bar display modes: Normal Mode:- Shows elapsed time on the left
- Remaining time on the right
- Seek bar fills from left to right
- Shows remaining time (time-to-end)
- Inverted seek controls for a unique experience
- Seek bar represents time remaining
Picture-in-Picture
Continue watching while using other applications:- Right-click on the video player
- Select “Picture in Picture”
- The video window stays on top of other applications
Object Fit Toggle
Switch between video display modes to match your content:- Contain - Displays the entire video with letterboxing if needed
- Cover - Fills the player area, potentially cropping the video
Advanced Features
Chapter Support
For videos with embedded chapter metadata:- Chapters are automatically detected and displayed
- Navigate between chapters using the chapter selector
- Chapter titles appear during playback transitions
Automatic Episode Progression
When watching TV series:- A “Next Episode” prompt appears near the end of each episode
- Automatically advances to the next episode when the countdown completes
- Skip the countdown by clicking the prompt
Error Recovery
The player includes robust error handling:- Network Errors - Automatic retry up to 5 times
- Media Errors - Attempts recovery up to 3 times
- Manual Retry - Use the retry button if automatic recovery fails
If a stream consistently fails, try selecting a different stream source from the streams menu.
Progress Tracking
Your viewing progress is automatically saved:- Resume from where you left off
- Progress syncs across devices when signed in
- Episodes marked as watched when 90% complete
- View progress indicators in your library
Performance Optimizations
Torrent Streaming
When streaming from torrents:- Smart buffering - Prioritizes pieces needed for immediate playback
- File selection - Choose specific files from multi-file torrents
- Progress indicators - View download progress and peer information
- Background processing - Continues downloading while you watch
Local File Playback
Local files benefit from optimized playback:- Direct playback without transcoding when possible
- Instant seeking with no buffering
- Metadata extraction for audio tracks and subtitles
- Frame-accurate positioning
HLS Server Integration
Raffi includes a built-in Go-based transcoding server:- Converts incompatible formats to HLS on-the-fly
- Handles EAC-3 audio transcoding for compatibility
- Slice-based seeking for efficient navigation
- Automatic cleanup when playback ends