Download App
← Back to Home
📋 SETUP & CONFIGURATION

Installation Guide

Everything you need to install and run CinePair on your desktop. Choose your platform, follow the steps, and start co-watching movies in minutes.

⚙️ System Requirements

Operating System Windows 10 (1809+)
RAM 4 GB minimum
Disk Space ~150 MB
Runtime WebView2 Runtime

Note: WebView2 Runtime is pre-installed on Windows 10 (20H2+) and Windows 11. If you're on an older build, download it from Microsoft's WebView2 page.

📥 Download Instructions

1

Visit the Releases Page

Go to the CinePair GitHub Releases page.

2

Choose the Windows Installer

Download the CinePair_x.x.x_x64-setup.exe or the .msi installer from the latest release assets.

3

Verify the Download

Check the file hash against the SHA-256 checksum listed in the release notes to ensure integrity.

🚀 Installation Steps

1

Run the Installer

Double-click the downloaded .exe or .msi file. If Windows SmartScreen appears, click "More info" → "Run anyway".

2

Follow the Setup Wizard

Accept the license agreement, choose your installation directory (default: C:\Program Files\CinePair), and complete the wizard.

3

Launch CinePair

Find CinePair in your Start Menu or desktop shortcut and launch it. The app will open and be ready to use immediately.

✅ Verification

Once installed, launch CinePair. You should see the main lobby screen where you can set your nickname and create or join a room. Try creating a test room to verify the signaling connection is active.

Application launches and connects to signaling server

⚙️ System Requirements

Operating System macOS 10.15+ (Catalina)
RAM 4 GB minimum
Disk Space ~120 MB
Architecture Intel (x64) or Apple Silicon (aarch64)

Note: macOS includes WebKit (WKWebView) natively, so no additional runtime is needed. CinePair uses Tauri's native WebKit integration.

📥 Download Instructions

1

Visit the Releases Page

Go to the CinePair GitHub Releases page.

2

Choose the macOS Bundle

Download CinePair_x.x.x_x64.dmg for Intel Macs or CinePair_x.x.x_aarch64.dmg for Apple Silicon.

3

Verify the Download

Open Terminal and verify the SHA-256 checksum:

$ shasum -a 256 ~/Downloads/CinePair_*.dmg

🚀 Installation Steps

1

Open the DMG File

Double-click the downloaded .dmg file to mount the disk image.

2

Drag to Applications

Drag the CinePair icon into the Applications folder shortcut in the mounted volume.

3

Handle Gatekeeper

On first launch, macOS may block the app. Go to System Preferences → Security & Privacy → General and click "Open Anyway". Alternatively, right-click the app and select "Open".

4

Grant Permissions

Allow screen recording and microphone access when prompted. These are required for screen sharing and voice chat.

✅ Verification

Launch CinePair from your Applications folder or Spotlight Search. The main lobby screen should appear. Create a test room to verify your signaling connection and WebRTC capabilities.

Application launches and screen sharing permissions granted

⚙️ System Requirements

Operating System Ubuntu 20.04+ / Fedora 36+ / Arch
RAM 4 GB minimum
Disk Space ~100 MB
Runtime webkit2gtk 4.1

Note: CinePair requires webkit2gtk-4.1 and related libraries. Install them first:

# Ubuntu/Debian: sudo apt install libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf # Fedora: sudo dnf install webkit2gtk4.1-devel libappindicator-gtk3-devel librsvg2-devel # Arch: sudo pacman -S webkit2gtk-4.1 libappindicator-gtk3 librsvg

📥 Download Instructions

1

Visit the Releases Page

Go to the CinePair GitHub Releases page.

2

Choose Your Package Format

Download the appropriate package for your distribution:

  • .AppImage — Universal, no installation needed
  • .deb — For Debian/Ubuntu-based distributions
  • .rpm — For Fedora/RHEL-based distributions
3

Verify the Download

Check the SHA-256 checksum in your terminal:

$ sha256sum ~/Downloads/CinePair_*

🚀 Installation Steps

1

AppImage (Recommended)

Make the AppImage executable and run it:

$ chmod +x CinePair_*.AppImage $ ./CinePair_*.AppImage
2

Debian Package (.deb)

Install using dpkg or apt:

$ sudo dpkg -i CinePair_*.deb $ sudo apt install -f # fix any missing dependencies
3

RPM Package (.rpm)

Install using dnf:

$ sudo dnf install CinePair_*.rpm

✅ Verification

Launch CinePair from your applications menu or by running the AppImage. If PipeWire or PulseAudio is configured, screen sharing audio should work automatically. Create a test room to verify your P2P connection.

Application launches with webkit2gtk and audio pipeline active
🔨 DEVELOPER BUILD

Build from Source

Want to customize CinePair or contribute? Build the entire application from source with these prerequisites.

Prerequisites

🦀 Rust v1.70+ (latest stable) Install via rustup →
📦 Node.js v18+ LTS recommended Download Node.js →
⚡ Tauri CLI v2.x Tauri v2 Docs →

Build Commands

# Clone the repository git clone https://github.com/Mr-Dark-debug/cinepair.git cd cinepair # Install frontend dependencies npm install # Install Tauri CLI cargo install tauri-cli --version "^2" # Run in development mode cargo tauri dev # Build a production release cargo tauri build

The production binaries will be output to src-tauri/target/release/bundle/ for your platform.

🛠️ TROUBLESHOOTING

Frequently Asked Questions

Windows SmartScreen may flag unsigned apps. Click "More info" and then "Run anyway". CinePair is open-source and safe to install. You can verify the integrity of the binary by checking the SHA-256 hash from the GitHub release page.

Right-click the app in Finder and select "Open", then confirm. Alternatively, go to System Preferences → Security & Privacy → General and click "Open Anyway" next to the CinePair warning.

This is usually a Wayland/PipeWire issue. Ensure you have xdg-desktop-portal and the appropriate backend installed:

# GNOME (Wayland): sudo apt install xdg-desktop-portal-gnome # KDE: sudo apt install xdg-desktop-portal-kde # wlroots-based (Sway, etc.): sudo apt install xdg-desktop-portal-wlr

CinePair requires WebView2 Runtime. It's pre-installed on Windows 10 (20H2+) and Windows 11. If it's missing, download the Evergreen Bootstrapper from Microsoft's WebView2 page and install it before launching CinePair.

Check the following:

  • Ensure you have an active internet connection
  • Verify the signaling server URL is correct in the app settings
  • Check if your firewall or VPN is blocking WebSocket connections
  • Try disabling browser extensions or proxy settings that may interfere

CinePair captures system audio during screen share. On Windows, ensure "Share system audio" is checked when selecting the screen source. On Linux, ensure PipeWire or PulseAudio is properly configured. On macOS, system audio capture requires additional screen recording permissions in System Preferences.

Download the latest release from the GitHub Releases page and install it over the existing version. Your settings will be preserved. On Linux with AppImage, simply replace the old file with the new one.