Initial setup
Launch Raffi
Open the Raffi application on your desktop or mobile device. On first launch, you’ll see the welcome screen.
Create an account or use local mode
Desktop: You can choose to:
- Sign in with Ave ID (recommended for cross-device sync)
- Continue in Local Mode (no account required, device-only storage)
- Click Sign In on the welcome screen
- You’ll be redirected to the Ave authentication page
- Create your account or sign in with an existing Ave ID
- You’ll be redirected back to Raffi
Install your first addon
Addons provide the streaming sources for movies and TV shows. Raffi is fully compatible with the Stremio addon ecosystem.
- Click the Settings icon (gear) in the top-right corner
- Navigate to Addons
- Browse the Community Addons section
- Click Install on any addon you want to use (e.g., Cinemeta for metadata)
Browse content
Return to the home screen to see:
- Popular movies and TV shows from your installed addons
- Search for specific titles using the search bar
- Categories and catalogs provided by your addons
Exploring key features
Continue watching
Your watch progress is automatically saved. Access Continue Watching from the home screen to resume where you left off.
Custom lists
Create collections by clicking the + icon on any title’s detail page. Organize your favorite content into custom lists.
Watch parties
Watch together with friends in real-time sync. Click the Watch Party button when viewing content to create or join a party.
Local files
Desktop: Add local video files by going to Settings → Library and adding your media folders. Raffi will scan and organize your local content.
Discord integration
Desktop: Enable Discord Rich Presence in Settings → Activity to show what you’re watching on your Discord profile.
Chromecast
Cast to your TV by clicking the cast icon in the video player. Raffi supports Chromecast-enabled devices.
Mobile quick start
If you’re using the mobile app, note these additional steps:The mobile app requires the streaming server component for torrent streams. The desktop app includes this server automatically. For mobile-only usage, you can:
- Run the desktop app on your home network to provide the streaming server
- Or deploy a standalone streaming server (see Server documentation)
- Configure the streaming server URL in the mobile app settings
- Ensure your mobile device and server are on the same network (or configure port forwarding)
- The mobile app will use the server for HLS transcoding
Customizing your experience
Adjust playback settings
Go to Settings → Playback to configure:
- Auto-play next episode
- Auto-skip intros
- Seek bar style
- Default quality preferences
Manage addons
In Settings → Addons, you can:
- Install new addons from the community
- Configure addon settings
- Reorder addon priority
- Remove unused addons
Troubleshooting
- No streams available
- Playback issues
- Sync not working
- Watch party issues
If you don’t see any streams for a title:
- Make sure you have streaming addons installed (not just metadata addons like Cinemeta)
- Try installing additional addons from different sources
- Some content may not be available through your current addons
Next steps
Explore features
Learn about all the features Raffi has to offer
Platform guides
Platform-specific tips and features
Configuration
Customize Raffi to your preferences
Join the community
Contribute, report issues, or get help on GitHub