Magi

Magi is a self-hosted, lightweight manga & light novel server and reader. Organize and read your personal digital manga collection through a modern web interface.

Important

Magi does NOT distribute copyrighted material. It's designed exclusively as a local library manager for your legally obtained manga files.

✨ Features

• Library Management: Automatic indexing, multi-library support, metadata fetching
• Reading Experience: Multiple reading modes, progress tracking, keyboard navigation
• User Management: Multi-user support with role-based access
• Discovery: Advanced search, tags, favorites, and reading lists
• Administration: Web-based configuration and job monitoring

📦 Supported Platforms

Magi compiles to a single portable binary for Linux, Windows, and macOS (amd64, arm64). Docker images available on Docker Hub.

Note

macOS builds do not include WebP image support due to platform limitations.

🚀 Quick Start

Using Docker (Recommended)

docker run -d \
  --name magi \
  -p 3000:3000 \
  -v /path/to/manga:/data/manga \
  -v /path/to/magi-data:/data/magi \
  alexbruun/magi:latest

Using Binary

1. Download from GitHub Releases
2. Extract and run: ./magi
3. Open http://localhost:3000 and create your admin account

Full docs: Installation & Usage

🧑‍💻 Development

Requires Go 1.25+. Clone and run with air for live reload.

🤝 Contributing

Contributions welcome! Report bugs, suggest features, or submit PRs to the next branch.

📄 License

MIT License