Makimedia
Help make Makimedia better
Makimedia is free and made by one person in the open. You don't need to write code to help: using it, testing it and telling us what goes wrong all count.
Use it, and tell a friend
The simplest help there is. Use Makimedia with your own library, and if you like it, tell someone who keeps films on a PC and watches them on a TV.
- Leave a rating on Google Play or the Microsoft Store
- Give the project a star on GitHub, which helps other people find it
Test it on your devices
Makimedia runs on a lot of different hardware, and no one person owns all of it. Every device that plays your files correctly, or doesn't, is useful to know about.
Android TV boxes are especially welcome. They vary the most, from how they decode 4K to how their remotes behave. If you have one, try playing a few of your files and streaming from your PC, and tell us how it went, even when everything worked.
Report a bug
Something broke, froze or looked wrong? Report it on GitHub Issues, or through the contact form if you don't have a GitHub account. A good report is fixed much faster. Include:
- Your device, for example "Windows 11 PC", "Samsung tablet" or "Android TV box", and the Makimedia version from Settings, About.
- What you did, step by step, so it can be repeated.
- What you expected, and what happened instead. A screenshot helps a lot.
- The log file, if you can. It records what the app was doing when things went wrong.
Where to find the log file
- Windows
- Open File Explorer, paste
%APPDATA%\TopicDev\Makimedia\logsinto the address bar and press Enter. The file ismakimedia.log. - Android phone and tablet
- Settings, Save log file, then choose where to save it.
- Android TV
- Settings, Save log file copies it to the Download folder.
Check it before posting it publicly. The log can contain the names of your folders and video files. GitHub Issues are public, so if you'd rather keep that private, attach the log to an email to support@makimedia.org instead. The contact form can't take attachments.
Suggest an idea
Missing something you'd use every day? Open an issue on GitHub describing what you want to do rather than how the app should do it, for example "I want to see which episodes I haven't watched across all shows". That leaves room for the best solution.
Makimedia stays deliberately focused: a fast, simple player for your own files. Some ideas won't fit, and that's fine to hear. Everything that does fit goes on the list.
Add a film series
Makimedia groups films into collections and universes, like the Marvel or Middle-earth films, in release or story order. Most come from TMDB, but some series TMDB never grouped are defined by Makimedia itself, in a plain data file: assets/universes.json in the source code.
If a series you love is missing, or its story order is wrong, you can help without writing any code: open an issue with the films in the right order, or edit the file and send a pull request. Series are added for everyone, so they should be well-known ones, not someone's personal list.
Write code
Makimedia is written in C++ and QML with Qt 6, and plays video with mpv. The repository explains how to build it; a fresh copy builds and runs without any API keys.
- Start small. A focused fix is far easier to review than a large change. For anything bigger, open an issue first so we can agree on the approach before you spend time on it.
- Read the project documents.
SPECS.mddescribes what the app is meant to be, andTASKS.mdlists what's left and what was already decided against. - Match the code around you, and keep the tests passing. They're built by default and run with
ctest. - Send a pull request that explains what it changes and why, and on which devices you tried it.
By contributing code, you agree that it's released under the same licence as Makimedia, the GNU General Public License, version 2 or later.
Translations, later
Makimedia is in English for now. Translations are planned; if you'd like to help with your language when the time comes, let us know.