https://github.com/ironexcavater/modlist-manager
A simple GUI application providing an interface to create and store your custom Minecraft 'modlists'. Seamlessly check compatibility or download the modlist for a specific Minecraft version and mod loader of your choosing.
https://github.com/ironexcavater/modlist-manager
curseforge curseforge-api minecraft mod-manager modrinth modrinth-api qol tkinter
Last synced: 11 months ago
JSON representation
A simple GUI application providing an interface to create and store your custom Minecraft 'modlists'. Seamlessly check compatibility or download the modlist for a specific Minecraft version and mod loader of your choosing.
- Host: GitHub
- URL: https://github.com/ironexcavater/modlist-manager
- Owner: IronExcavater
- License: mit
- Created: 2024-04-28T05:46:28.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-02T02:31:04.000Z (almost 2 years ago)
- Last Synced: 2025-03-31T12:57:42.646Z (about 1 year ago)
- Topics: curseforge, curseforge-api, minecraft, mod-manager, modrinth, modrinth-api, qol, tkinter
- Language: Python
- Homepage:
- Size: 111 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Modlist Manager
## Purpose
Have you ever tried to update your custom modpack to a different Minecraft version, only to end up losing interest for
playing Minecraft and playing something else? This can be a very annoying task; opening each mod download page, sorting
through it, downloading the correct version and moving it to your mods folder. I have dealt with this many of times, to
the point that I created this project!
A simple GUI application providing an interface to create and store your custom Minecraft 'modlists'. Seamlessly
check compatibility or download the modlist for a specific Minecraft version and mod loader of your choosing. Utilises
APIs from popular platforms of CurseForge and Modrinth to achieve a holistic approach. Take advantage of the various
quality-of-life features/tools including sorting, finding, selecting and deleting which aim to decrease your time
managing your modlists and instead increasing your time enjoying Minecraft!
## Features
- [X] Utilises both CurseForge and Modrinth APIs
- [X] Interactive application design with immediate feedback
- [X] Check version compatibility of mods
- [X] Dynamic sorting and locating tools
- [X] Simple .txt saving and loading functionality
- [X] Hassle-free and automatic dependency handling
- [X] Cross-platform support for Windows and Mac
- [ ] Fix Mac application to run without terminal
## Installation
1. Open the 'dist' folder in the GitHub repository which stores the various installers for the application.
2. Download the suitable installer for your operating system,
Windows: ***.msi***
Mac: ***.dmg***
3. Run the installer, follow its prompts, open the application and violà!
**Note for Windows:**
When saving, the modlists are stored in the 'modlists' directory within the installation directory. If you remove/update the application,
make sure to keep a backup of those .txt files, otherwise, your modlists will be lost to the eternal pit of being
overridden.
**Note for Mac:** Currently (v0.3), the application cannot be opened normally from its icon. I will try to fix this, but
a quick workaround to open the application is with these steps:
1. Locate the application in your *'applications'* folder and right-click to open the context menu.
2. Within the context menu, click *'Show Package Content'*
3. Open these folders: *'Contents'*, then *'MacOS'*
4. Then run the *'Modlist Manager'* with the exec icon and violà!
## Contributing
As of right now, I'm not actively expanding the projects features. However, if you have a suggestion, feel free to post
it in this GitHub repository. I will do my best to respond and implement your ideas. If you find a bug, let me know and
I will fix these as soon as possible! Thanks.
## Licence
Modlist Manager is under the MIT License which you can learn more about in the [repository](https://github.com/IronExcavater/Modlist-Manager/blob/main/LICENSE).
## Credits
As Python's Base Tkinter Styling is horrible and it would be a hassle to create an appealing CustomtKinter, the
alternative was to use external Tkinter style packages. This project uses [Sun-Valley-ttk-theme](https://github.com/rdbende/Sun-Valley-ttk-theme) by [rebende](https://github.com/rdbende), a massive
glow-up without the effort (like plastic surgery).
Thanks to [cx_Freeze](https://github.com/marcelotduarte/cx_Freeze) by [marcelotduarte](https://github.com/marcelotduarte), the project was easily be
converted into applications for Windows and Mac operating systems. With the added cross-compatibility, the project has
greater accessibility for non-developers.
To speed up the implementation of both the CurseForge and Modrinth API, this project utilises 'middle-man' python
packages which wrap functionality into classes. As such, thanks to [cursepy](https://github.com/OwenCochell/cursepy) by [OwenCochell](https://github.com/OwenCochell)
and [modrinth.py](https://github.com/betapictoris/modrinth.py) by [betapictoris](https://github.com/betapictoris).