Installation

This guide covers installation of Momovu on Linux systems.

System Requirements

Minimum Requirements

  • Operating System: Linux

  • Python: 3.9 or higher

  • RAM: 4 GB minimum, 8 GB recommended

  • Disk Space: 500 MB for installation

  • Display: 1280x720 minimum resolution

Quick Install

Installation Instructions

Linux (Debian)

  1. Install system dependencies:

sudo apt update
sudo apt install python3-pip python3-venv python-is-python3
sudo apt install libxcb-xinerama0 libxcb-cursor0  # Qt dependencies
  1. Create a virtual environment (recommended):

python3 -m venv ~/momovu-env
source ~/momovu-env/bin/activate
  1. Install Momovu:

pip install --upgrade pip wheel setuptools
pip install momovu

Install from Source

For users who want the latest development version:

Clone the Repository

git clone https://spacecruft.org/books/momovu
cd momovu/

Install the Application

  1. Create and activate a virtual environment:

python -m venv venv
source venv/bin/activate
  1. Install in user mode:

pip install --upgrade pip wheel setuptools
pip install -e .

Verification

After installation, verify Momovu is working:

# Check version
momovu --version

# Show help
momovu --help

# Test with a sample PDF (if available)
momovu sample.pdf

Uninstallation

To remove Momovu:

Using pip

pip uninstall momovu

Complete Removal

  1. Uninstall the package:

pip uninstall momovu
  1. Remove virtual environment (if used):

rm -rf ~/momovu-env
  1. Remove configuration files (if any):

rm -rf ~/.config/momovu

Next Steps

After successful installation:

  1. Read the Usage guide to learn about features

  2. Try the sample PDFs in the repository

  3. Configure your preferred document types

  4. Explore keyboard shortcuts for efficient workflow