Skip to main content

MaroHub Documentation

Everything you need to use the catalog and the Maro CLI.

Introduction

What MaroHub is and how it works

CLI Reference

Complete command line reference

FAQ

Common questions about the catalog

Contributing

Help grow the game database

Contact

Get in touch with the maintainers

Introduction

MaroHub indexes ready-to-run Linux games and serves them through magnet links. The web app handles discovery: search, filter by genre or rating, and open a game page. The Maro CLI does the same work from a terminal.

  • Search and filter the catalog by genre, year, rating, or download size
  • Every game links to a magnet torrent, no ads and no accounts
  • Native Linux installs and Wine/Proton builds are tagged separately
  • Built for Linux gamers, by Linux gamers

CLI Reference

Commands

maro search <query>Search for games by name or keyword
maro listList all available games
maro info <game-id>Show detailed info for a game
maro install <game-id>Prepare a game for download
maro remove <game-id>Remove an installed game
maro updateRefresh the local game database
maro helpShow help and usage info

Examples

$ maro search doom
$ maro info 42
$ maro install 42

FAQ

What do I need to download a game?

A torrent client that supports magnet links, such as qBittorrent or Transmission. Open the magnet link on a game page and your client takes it from there.

Native Linux or Wine/Proton?

Games tagged Native Linux run without a compatibility layer. Wine/Proton builds need Wine or Proton installed. The tag is shown as a badge on each game page.

Is the site ad-free and private?

Yes. No ads, no accounts, no tracking. Your wishlist lives in your browser and never leaves it.

Why is a game missing?

The catalog is community-maintained. Every addition goes through the repository, so it updates when someone contributes.

Contributing

The game database lives in data/games.json in the repository. Add entries, fix game metadata, or improve the web app and CLI.

Report a broken game

Open an issue with the game name and what fails, such as a dead magnet link or missing metadata.

Add a new game

Insert an entry in data/games.json matching the current schema and open a pull request.

Open the repository

Contact

Get in touch with the maintainers:

MIT License

Copyright (c) 2025 ammar mohamed (ammar0xf)

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND...