Installing Raffi
Raffi is available on all major platforms. Download the appropriate installer for your operating system from raffi.al or the GitHub Releases page.
The latest stable version is v0.7.0. Always download from official sources to ensure you get the authentic application.
Windows
macOS
Linux
Mobile
Windows Installation
Raffi provides two installation options for Windows users:Installer (Recommended)
The NSIS installer is the easiest way to install Raffi on Windows.Run the installer
Double-click the downloaded .exe file and follow the installation wizard
Launch Raffi
Once installed, Raffi will be available in your Start Menu and Desktop
MSI Portable Package
For users who prefer a portable installation or need enterprise deployment:Download the MSI package
Download Raffi-x.x.x.msi from the releases page
Install via MSI
Double-click the .msi file or use command line:msiexec /i Raffi-x.x.x.msi
Both installers include the required streaming server binary (decoder-windows-amd64.exe) for HLS transcoding.
macOS Installation
Raffi supports both Intel and Apple Silicon Macs.DMG Installation (Recommended)
Download the DMG
Download the .dmg file from raffi.al or GitHub releases Mount the disk image
Double-click the downloaded DMG file to mount it
Drag to Applications
Drag the Raffi app icon to your Applications folder
Launch Raffi
Open Raffi from your Applications folder or Launchpad
ZIP Installation
Download the ZIP
Download the .zip archive from the releases page
Extract the archive
Double-click to extract, or use:unzip Raffi-x.x.x-mac.zip
Move to Applications
Move the extracted Raffi.app to your Applications folder
First Launch on macOS: You may see a security warning since the app is not notarized. Right-click the app and select “Open” to bypass this, or go to System Preferences > Security & Privacy and click “Open Anyway”.
The macOS build includes streaming server binaries for both architectures:
decoder-aarch64-apple-darwin (Apple Silicon)decoder-x86_64-apple-darwin (Intel)
Linux Installation
Raffi supports multiple Linux package formats for maximum compatibility.Debian/Ubuntu (.deb)
For Debian-based distributions including Ubuntu, Linux Mint, and Pop!_OS:# Download the package
wget https://github.com/kaleidal/raffi/releases/download/vX.X.X/Raffi-x.x.x.amd64.deb
# Install with dpkg
sudo dpkg -i Raffi-x.x.x.amd64.deb
# Fix dependencies if needed
sudo apt-get install -f
Fedora/RHEL (.rpm)
For Red Hat-based distributions including Fedora, CentOS, and RHEL:# Download the package
wget https://github.com/kaleidal/raffi/releases/download/vX.X.X/Raffi-x.x.x.x86_64.rpm
# Install with rpm
sudo rpm -i Raffi-x.x.x.x86_64.rpm
AppImage (Universal)
AppImage works on any Linux distribution without installation:Download the AppImage
Download Raffi-x.x.x.AppImage from the releases page
Make it executable
chmod +x Raffi-x.x.x.AppImage
AppImage Benefits: No installation required, no root access needed, and works on any modern Linux distribution.
Post-Installation
After installation, Raffi will be available in your application menu under the “Video” category, or you can launch it from the terminal:The Linux build includes the streaming server binary decoder-x86_64-unknown-linux-gnu for HLS transcoding.
Mobile Installation
Raffi’s mobile companion app is available for iOS and Android, offering seamless sync with your desktop installation.iOS
Download from App Store (Coming Soon)
The iOS app will be available on the Apple App Store soon
TestFlight Beta
For early access, join the TestFlight beta program (link coming soon)
- iOS 13.0 or later
- Compatible with iPhone and iPad
Android
Download from Play Store (Coming Soon)
The Android app will be available on Google Play Store soon
Direct APK Install
Download the APK from GitHub releases and install manually
- Android 6.0 (Marshmallow) or later
Mobile App Features
- Browse and search your content library
- Native video playback with Expo Video
- Continue watching with progress sync
- Cross-device authentication via Supabase
- Custom torrent-streamer module for on-device streaming
Bundle Identifiers:
- iOS:
al.kaleid.mobile
- Android:
al.kaleid.raffimobile
For torrent streaming on mobile, you may need to configure the streaming server URL to point to your desktop app or a remote server. Update STREAMING_SERVER in the app settings.
System Requirements
Desktop (Windows, macOS, Linux)
- CPU: Modern dual-core processor (quad-core recommended)
- RAM: 4GB minimum (8GB recommended)
- Storage: 500MB for application + space for cached content
- Graphics: Hardware video acceleration recommended
- Network: Broadband internet connection for streaming
Mobile (iOS, Android)
- iOS: iOS 13.0 or later, 2GB RAM recommended
- Android: Android 6.0 or later, 2GB RAM recommended
- Storage: 200MB for app + space for cached content
- Network: Wi-Fi or 4G/5G connection recommended
Verifying Your Installation
After installation, verify that Raffi is working correctly:
Launch Raffi
Open the application from your system’s application menu
Check version
Look for the version number in the app settings (should be v0.7.0 or higher)
Test streaming server
The bundled streaming server should start automatically. Check the app logs if you encounter playback issues.
Updating Raffi
Raffi includes an auto-updater that will notify you when new versions are available.
Automatic Updates: Raffi will check for updates on launch and prompt you to install them. You can also manually check for updates in the app settings.
Troubleshooting
Windows
- App won’t launch: Make sure you have the latest Visual C++ Redistributable installed
- SmartScreen warning: Click “More info” and “Run anyway” to bypass
macOS
- “App is damaged”: Right-click the app and select “Open” instead of double-clicking
- Streaming issues: Check that the decoder binary has execute permissions
Linux
- Missing dependencies: Run
sudo apt-get install -f (Debian/Ubuntu) to fix
- AppImage won’t run: Ensure FUSE is installed:
sudo apt install fuse
Mobile
- Can’t connect to server: Verify your streaming server URL in app settings
- Playback issues: Ensure you’re on the same network as your desktop app (for local streaming)
Next Steps
Now that you have Raffi installed, head over to the Quick Start guide to configure your first addons and start streaming!