In order to install Moe Moe Secretary, please download the latest jar from the Github Releases
You'll need a JRE (1.8+) installed, you can get it here.
Place the JAR file in a secure place, better if it's in a folder
All the key commands must be used after clicking the waifu in order to obtains window focus.
- Double click the jar file to start Moe Moe Secretary,
once started you'll find a waifu floating on your desktop (Ptilopsis from Arknights) - Move her around by dragging her
- Click her to trigger "on click" dialogs
- Close her by clicking the mouse wheel on her
(if you don't have a mouse wheel, ALT F4 combination will do the job) - If the adapter supports skin, you can switch them pressing J and K keys
- By default the waifu should be on always-on-top mode, to toggle it press the T key
- Flip the waifu by pressing S key
- Toggle floating effect by pressing the F key
In the JAR file's folder, after starting MMS at least once, there will be a folder named "config",
inside it you'll find a file named config.properties.
config.properties file contains all the settings for your secretary.
TIP: Saving this file will apply the changes to the secretary on the fly.
Check the next table to see all the possible Adapters and adapter-configurations.
All the other settings are self-explanatory.
Adapters are used to access different waifus on the internet.
Moe Moe Secretary uses public wikis data to download images and dialogs, where available.
If you think that a wiki does not like this behaviour, please open an issue.
The following table shows the adapter names to be used in the .properties file and their relative detailed chapter.
| Adapter Name | Chapter |
|---|---|
| AzurLane | Azur Lane Chapter |
| GenshinImpact | Genshin Impact Chapter |
| Arknights | Arknights Chapter |
| SinoAlice | SinoAlice Chapter |
| SIFIdol | SIFIdol Chapter |
| GirlsFrontline | Girls Frontline Chapter |
| MirageMemorial | Mirage Memorial Chapter |
| Github | Github Chapter |
| MMS Official Github | MMS Github Chapter |
| File | File Chapter |
| Feature | Azur Lane | Arknights | SINoALICE | SIFIdol | GirlsFrontline | MirageMemorial |
|---|---|---|---|---|---|---|
| Dialogs | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Voices | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ |
| Skins | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ |
This adapter takes the data from https://azurlane.koumakan.jp
Ship names are the same as in-game names, if you can't really find one take a look here.
This adapter takes the data from https://genshin-impact.fandom.com
Character names are the same as in-game names, if you can't really find one take a look here.
This adapter takes the data from https://github.com/Aceship/AN-EN-Tags
Operator names are the same as in-game names, if you can't really find one, search for it here
This adapter takes the data from https://sinoalice.game-db.tw
Characters names are the same as in-game names, if you can't really find one take a look here.
This adapter takes card images from https://schoolido.lu and quotes from https://decaf.kouhi.me/lovelive/index.php
This adapter requires the card ID as waifu.name in the config.properties, be sure to match the card ID from here.
This adapter takes the data from https://en.gfwiki.com
Weapon names are the same as in-game names, if you can't really find one take a look here
This adapter takes the data from https://miragememorialglobal.fandom.com/wiki
Servant names are the same as in-game names, if you can't really find one take a look here:
find your servant, click on the image and look at the URL, it'll end with "?file=Aristotle.png"
use the string after = (without .png) (in this case Aristotle)
Github adapter is the best one, but it has a cost: waifus must be implemented manually first.
Moe Moe Secretary has an official repository for custom waifus (mostly VTubers), check the next chapter.
Github adapter requires some additional parameters in the config.properties:
adapter=Github
waifu.name=path/Name
adapter.file.format=format
github.repo=Username/repo
github.branch=branchThose are the required parameters in order to use the github adapter,
check the next chapter to see some example values.
- You can create your own waifus and host them on Github.
This adapter supports all MMS features!
Moe Moe Secretary has its own Github waifu repository.
In order to use it set the following values in your config.properties:
adapter=Github
waifu.name=VTuber/Hololive/Calliope
adapter.file.format=YAML
github.repo=KaikyuLotus/moe-moe-secretary-waifus
github.branch=masterWith those settings Calliope-sama should pop-up on your desktop!
Want to add more waifus?
Create an issue to add them or fork that repo and add them yourself, I'll accept PRs.
Please take a look at this link:
https://telegra.ph/Moe-Moe-Secretary-File-Adapter-Configuration-01-12
It may be out of date, if so please open an issue or contact me on Telegram.
If MMS crashes with a certain adapter or character you can open an issue or join the official Telegram group!
We also have a CI bot, so you can update your MMS version directly from Telegram!
Also check the FAQs
- Q: I want my waifu to start on my PC startup, how to do it?
A: Setwaifu.autoStartupEnabledtotruein your config.properties - Q: MMS requires internet access to work?
A: Yes, it does, if you don't want it you could use the file adapter. - Q: Can you add <character name>?
A: Yes, most probably, please open an issue with some details of the requested character.
Details on contributions will be added later.
