Mikan automatically downloads cards from various idol or idol-adjacent gacha mobile games.
The following games are currently supported:
- Love Live! School Idol Festival (via School Idol Tomodachi)
- Love Live! School Idol Festival ALL STARS (via Idol Story)
- Love Live! School Idol Festival 2 (via Idol Story)
- BanG Dream! Girls Band Party! (via Bandori Party)
- Revue Starlight -Re LIVE- (via Starlight Academy)
- IDOLM@STER Cinderella Girls Starlight Stage (via Cinderella Producers)
To install Mikan, you need to install pipx (see instructions) and then run pipx install mikan-card-downloader.
To update it, run pipx upgrade mikan-card-downloader.
Installing through pip is also possible, but not recommended, and since Python 3.11 requires the --break-system-packages flag.
(Note: this software requires Python>=3.10 and Poetry)
- Clone this GitHub repository (
git clone https://github.com/DemonicSavage/mikan.git) - Go to the
mikandirectory (cd mikanon Unix). - Run
poetry installto grab the necessary dependencies.
The configuration file currently has the following options:
# Path for the downloaded cards
[Paths]
data_dir = ~/Idol_Cards
# Other options
[Other]
# Formerly needed for SIF2 support
cookie = your_sessionid_cookie
# Maximum concurrent connections, default is 10
max_connections = 10You can find this file in $XDG_CONFIG_HOME/mikan on Linux, %APPDATA%\Local\mikan\mikan on Windows, or /Library/Application Support/mikan on macOS.
This is a command line script. It first creates (or updates) a metadata file about the available cards (items.json), and then downloads the image files themselves.
By default, running mikan without any arguments will create metadata and then download SIF2 cards.
Arguments can be passed to mikan to download cards from other games. Run mikan --help to see what arguments are available.
Note that for now, you need a
This is no longer the case.sessionid cookie for an Idol Story account with beta-testing enabled for SIF2 support.
Running it for the first time will prompt you for the directory cards and stills should be downloaded to.
This software is released under the GNU GPLv3 license, and its dependencies are released under their respective licenses.