Skip to content

Movian Installation Guide

This directory contains comprehensive installation instructions for building and installing Movian on all supported platforms.

Quick Platform Selection

Platform Guide Difficulty Build Time
Ubuntu/Debian Linux Guide Easy 15-30 min
Fedora/CentOS Linux Guide Easy 15-30 min
macOS macOS Guide Medium 20-40 min
Windows Windows Guide Hard 30-60 min
Android Cross-Platform Guide Hard 45-90 min
Raspberry Pi Cross-Platform Guide Medium 30-60 min
PlayStation 3 Cross-Platform Guide Hard 60+ min

Prerequisites

Before starting, ensure you have:

  • Git - For cloning the repository
  • Build tools - Platform-specific compilers and build systems
  • Dependencies - Required libraries (see System Requirements)
  • Disk space - At least 2GB free space for build
  • Internet connection - For downloading dependencies

For detailed system requirements and dependency information, see the System Requirements guide.

Installation Overview

graph TB
    Start([Start Installation])

    subgraph "Platform Detection"
        Linux{Linux?}
        macOS{macOS?}
        Windows{Windows?}
        Other{Other Platform?}
    end

    subgraph "Dependency Installation"
        LinuxDeps[Install Linux Dependencies]
        macOSDeps[Install macOS Dependencies]
        WindowsDeps[Setup Windows Build Environment]
        CrossDeps[Setup Cross-Compilation]
    end

    subgraph "Build Process"
        Clone[Clone Repository]
        Configure[Run Configure Script]
        Build[Compile Source Code]
        Install[Install Binary]
    end

    subgraph "Verification"
        Test[Test Installation]
        Troubleshoot[Troubleshoot Issues]
        Success([Installation Complete])
    end

    Start --> Linux
    Start --> macOS
    Start --> Windows
    Start --> Other

    Linux --> LinuxDeps
    macOS --> macOSDeps
    Windows --> WindowsDeps
    Other --> CrossDeps

    LinuxDeps --> Clone
    macOSDeps --> Clone
    WindowsDeps --> Clone
    CrossDeps --> Clone

    Clone --> Configure
    Configure --> Build
    Build --> Install

    Install --> Test
    Test --> Success
    Test --> Troubleshoot
    Troubleshoot --> Configure

Quick Start (Ubuntu/Debian)

For the impatient, here's a one-liner for Ubuntu/Debian systems:

# Install dependencies, clone, build, and install
sudo apt-get update && \
sudo apt-get install -y git build-essential libfreetype6-dev libfontconfig1-dev \
    libxext-dev libgl1-mesa-dev libasound2-dev libgtk2.0-dev libxss-dev \
    libxxf86vm-dev libxv-dev libvdpau-dev yasm libpulse-dev libssl-dev \
    curl libwebkitgtk-dev libsqlite3-dev libavahi-client-dev && \
git clone https://github.com/andoma/movian.git && \
cd movian && \
./configure && \
make -j$(nproc) && \
sudo make install

Platform-Specific Guides

Linux Installation

Complete guide for Linux distributions including: - Ubuntu/Debian package installation - Fedora/CentOS/RHEL setup - Arch Linux installation - Generic Linux from source - Development environment setup

macOS Installation

Comprehensive macOS build guide covering: - Xcode and command line tools setup - Homebrew dependency management - Native compilation and app bundle creation - Code signing and distribution

Windows Installation

Windows build instructions for: - MinGW-w64 cross-compilation - Visual Studio native compilation - MSYS2 development environment - Dependency management with vcpkg

Cross-Platform Builds

Advanced cross-compilation for: - Android devices and Android TV - Raspberry Pi and ARM boards - PlayStation 3 homebrew - iOS devices (experimental)

Build System Documentation

For detailed information about Movian's build system: - System Requirements - Hardware, software, and dependency requirements - Build System Overview - Architecture and configuration - Troubleshooting Guide - Common issues and solutions

Development Environment Setup

IDE Platform Setup Guide
Visual Studio Code All VSCode Setup
CLion All CLion Setup
Xcode macOS Xcode Setup
Code::Blocks Linux/Windows Code::Blocks Setup

Debugging Tools

  • GDB - GNU Debugger for Linux/macOS
  • LLDB - LLVM Debugger for macOS/iOS
  • Valgrind - Memory debugging on Linux
  • AddressSanitizer - Memory error detection
  • Movian Debug Mode - Built-in debugging features

Common Issues

Build Failures

  • Missing dependencies → Check platform-specific dependency lists
  • Compiler errors → Verify compiler version and flags
  • Linker errors → Check library paths and versions

Runtime Issues

  • Segmentation faults → Build with debug symbols and use debugger
  • Missing libraries → Check LD_LIBRARY_PATH or install missing packages
  • Permission errors → Verify file permissions and user privileges

Performance Issues

  • Slow startup → Check plugin loading and disable unnecessary features
  • High CPU usage → Profile with system tools and optimize build flags
  • Memory leaks → Use Valgrind or AddressSanitizer for detection

Getting Help

Documentation

Community Support

Contributing

Next Steps: 1. Choose your platform from the guides above 2. Follow the step-by-step instructions 3. Test your installation with a simple media file 4. Explore plugin development or UI customization

Need Help? Check the troubleshooting guide or ask for help in the community forum.API