For new users: Download chihiro.rar, extract to wherever you want and run chihiro.exe. I will not do a non-Windows release. If you get a virus warning from an AV, clone the repo, install the requirements and run chihiro.py; or you will have to trust my file and whitelist the exe. The first time you run the tool, it will need a few minutes to fetch all data (can be up to 10 minutes). Subsequent runs will not take as long.

For existing users: For new minor/major version, you will have to redownload the whole package (chihiro.rar). Between incremental releases of the same minor version, you can just download the patch (chihiro.exe). To update, extract the package and overwrite the tool folder, or move the patch into the tool folder and overwrite the current exe.

In case of unknown crashes, try removing the cache data (chihiro/data/db/chihiro.db). If the issue persists, report on reddit or github.

Almost everything is fetched directly from the game server/kirara, with the exception of song name translation which is done by me, so you don’t have to wait for anything to update. Just boot up the tool and if the song data is available in game, it will be in the tool.

For a start, you can try importing all your cards using your in game ID. Cards in the tool can be drag’n’drop. All options should be self-explanatory, but if you are experiencing any trouble or want to learn shortcuts, read on.

Interface

Simulator (+ Potentials)
Unit manager
Card list
Song list (+ Chart Viewer)
Support team (+ Custom card values)
Custom appeal bonus
Import cards from ID
Tips view

Simulator

The main part of the tool. You add cards here to make a unit, then run simulations to see what score you can get.

WIDE simulations

WIDE: Each line in this view is a unit. Each unit has 6 squares, each for a card. The red slot (left most) is the center card, the blue slot (right most) is the guest. Cards can be drag’n’drop from the card list to the squares. To remove a card from a unit, right click the card.

Guest cards automatically have 10, 10, 10, 5, 0 potentials.

GRAND simulations

GRAND: Each line in this view is a grand unit. A grand unit consists of 3 5-card units - A, B, C from top to bottom. Controls are similar to WIDE view (drag’n’drop cards, right click to remove).

Columns:

Appeals: Total appeals of the unit.
Life: Total life of the unit.
Perfect: Score on a perfect simulation (see definition below).
Mean: Arithmetic average score of all simulations.
Max: Highest score achieved in all simulations.
Min: Lowest score achieved in all simulations.
Fans: The average total fan gain per play.
Theo. Max: The theoretical maximum score achievable.
90/75/50%: Top 90/75/50% score in all simulations.

To run simulations for a single unit, double click a line.

To run simulations for all units, use the big “Run” button.

Buttons and options:

Run: Run all simulations sequentially.
Add Empty Unit: Insert an empty unit.
Yoink #1 Unit: Copy the current build from the top ranker of a song, with all potentials and support team into the simulator. Will forcefully disable custom pots and enable custom support options.
Permute Units: Only usable in GRAND view. Will create all permutations of existing GRAND units.
--- times: Number of times to run simulations. You can put from 0 up to 999 times. The bigger this number, the longer it will take to finish all simulations. Do not put big numbers for GRAND simulations.
Perfect Simulation: Run a perfect simulation where all notes are hit exactly at 0ms offset and all skills are activated as long as the probability is larger than 0. This option provides the best running time, put this on if you are not interested in random simulations.
Mirror: Mirror the chart, only has effect in autoplay mode and chart viewer.
Custom Potentials: Force all cards to use the custom potential options. Note that not setting the option means 0 potentials.
Theoretical Max: Get the highest possible score for a unit.
Bound: Set how skill detection works.

( or ) means exclusive, [ or ] means inclusive, where exclusivity means that a skill that activates/deactivates at exactly the same time as a note will not affect that note, whereas inclusivity means that note will have the skill effect.

2x Life Start: Start a song with life overhealed to 2x. Useful for grooves.
Support Appeal: Force all builds to use this value for support appeal. Set to 0 if you are running simulations for carnivals.
Total Appeal: Force all builds to use this value as the total appeal. Will overwrite “Support Appeal”.
Autoplay Mode: Switch to autoplay mode. Check the Autoplay section for details. Will negate the effect of “Perfect Simulation”, “--- times”.
Autoplay Offset: Check the Autoplay section for details.

Shortcuts:

To remove the whole unit, select the unit and press “Del”.
To clone a unit (without custom card values), select the unit and press “Ctrl+D”.
To clone a unit (with custom card values), select the unit and press “Ctrl+Shift+D”.

Unit manager

You can save your units here for future use.

Creating and saving units

Similar to the simulator view, you can drag and drop cards from the card list into card slots in the unit manager.

Or you can drag and drop a unit directly from the simulator view into the unit manager to add the whole unit.

Drag and drop a GRAND unit will add the 3 5-card units instead.

Units need to have names to be saved.

To avoid data loss from crash, press “Ctrl+S” to force save your units.

Using units

You can drag and drop units from the unit manager to the simulator view to add units.

Moving a 6-card unit into the GRAND simulator view will add only the first 5 cards to the GRAND unit.

Buttons and options:

Add unit: Add an empty unit.
Delete unit: Remove the unit from the unit manager.

Shortcuts:

To force save the unit list, press “Ctrl+S”. Note that units without names are not saved.

Card list

You can search for and view data from all cards here.

Quicksearch

Type into the quicksearch bar to update the card view in real time.

Accepted keywords:

Card name in the "%name%%number%" notation, e.g. uzuki3, karen4u, rinsr5.

Special name: anya instead of anastasia

Character name, e.g. uzuki, rin.
Rarity (nu, ru, sr, sru, ssr, ssru): n and r are not accepted due to being too short
Color (cool, cute, passion)
Skill name (overload, coordinate, skill boost, alternate, etc.), short names are available as well (OL, SB, CU, SYN, etc.)
Leader skill name (princess, unison, etc.)
Skill time + probability type (7hi, 6med, etc.)
Main attribute (visual, vocal, dance, balance)
Special keywords: fes, noir, blanc, carnival

Wildcards are accepted, e.g. “prin*” will match “princess”.

With the “Partial match” option on, all keywords will automatically have wildcards attached. So you only need to type “uzu” with the option enabled to match “uzuki”.

Advanced query:

Queries like uzuki OR (miku AND "skill boost") are possible, though I don't see much use from those.
owned:[1 TO 5]

Adding cards

To add cards, click on the “Owned” cell of a card then type the star rank in. I suggest importing from your game ID first to save you the trouble.

Buttons and options:

Highlight Carnival Idols: Add a gray background to all idols that get 70% appeal bonus in GRAND BOOTH during carnivals.
SSR only: Only display cards with SSR/SSR+ rarity.
Idolized only: Only display cards with N+/R+/SR+/SSR+ rarity.
Owned cards only: Only display cards with Owned > 0.
Partial match: Allow partial match in quicksearch. See the “Quicksearch” section above for details.
Icon (No icon / Small icon / Medium icon / Large icon): Hide or display image in the card list. Small = 32x32, Medium = 64x64, Large = 128x128. Using larger icons will eat up more RAM.

Shortcuts:

Press "Ctrl+F'' anywhere to move to the quicksearch bar.
In the quicksearch bar, you can press Ctrl/Alt+1-9/0 to send the 1st-10th card to the first empty slot in the simulator. Using Alt will skip the guest slots.

Song list

You can search for and select songs here.

Song names are manually translated/transliterated by me. If you see a new song not updating in the app, either use the japanese name or wait for a few hours until I have time to update it.

Columns are sortable.

Quicksearch

Type into the quicksearch bar to update the song view in real time.

Accepted keywords:

Song name (without stylization), e.g. “MAGIC” instead of “M@GIC☆”
Song name in Japanese, e.g. “輝く世界の魔法”
Chart difficulty (debut, regular, pro, master, smart, trick, mplus, legacy, piano, forte)
Level: just type the number in, or use this type of query “level:30”
Color: just type color in (cute, cool, passion, all), or use this type of query “color:cool”
Performers, e.g. kaede mizuki will match Nocturne
Song types (solo, solo2, mix, collab)

Queries have partial matching.

Buttons and options:

Right click in the song list view to switch between note count and note percentage views:

Double clicking a song will pop up the chart viewer.

Chart viewer

To use the chart viewer, click “Popup Chart Viewer”, or double click a song.

To change the song, just click on any song.

Chart viewer (example is Great Journey M+)

To load a unit into the chart viewer, click on any unit.

Chart viewer (example is Great Journey M+ with skills)

To load note abuse details into the chart viewer, double click on a unit with “Theoretical Max” on and the chart viewer opened.

Chart viewer (example is Great Journey M+ with abuse)

You can drag the chart around. Just do it like you would on a phone.

Press Ctrl + S inside the chart viewer to export the chart image as PNG.

GRAND examples next page.

Chart viewer (example is Starry-Go-Round PIANO)

Chart viewer (example is Starry-Go-Round PIANO with skills)

Chart viewer (example is Starry-Go-Round PIANO with abuse)

Notice how hitting 2 simple notes just slightly late gives you 8 more PRP.

Support team (+ Custom card values)

Support team

This window displays the support team used for a unit. Support cards are automatically calculated from your owned cards, song color, custom appeal bonuses, etc. Columns are also sortable.

The support team will be calculated when you click on a unit in the simulator view (which makes sense since each unit has one support team).

Custom card values

This feature is for advanced users only. You can directly edit a card value using this tab.

Fields under this tab are not validated! Which means typing an invalid value might crash the tool. I have no intention to fix this, the responsibility falls on you to make sure the values you input are valid.

Options:

Color: 1=cute, 2=cool, 3=passion
Vocal/Dance/Visual/Life: Base Vo/Da/Vi/Lf values (without potentials)
Skill Duration: Duration of active skill
Skill Interval: Interval of active skill
Vocal/Dance/Visual/Life/Skill Potentials: Custom potentials for the card
Star Rank: Integer from 1 to 20 (inclusive).

Custom appeal bonus

You can set custom appeal bonuses here.

Manually set

If you know what you need, you can manually set the values in the 5x3 grid. The values are in percent.

Presets

Some presets require the bonus value (set in the box right under “Appeal Presets”).

Color preset determines what cards will get the bonuses:

All colors
Cute
Cool
Passion

Appeal preset determines what kind of bonuses to add:

All Attributes: Add to Vo/Da/Vi
Vocal/Dance/Visual Groove: Add to only Vo/Da/Vi, while you can put your own value, the value used in grooves is 150.
Vocal/Dance/Visual Only: Add to only Vo/Da/Vi, and negate the other appeals
Scale with Star Rank: Ignores color preset and appeal preset bonus value.
Scale with Life: Ignores color preset and appeal preset bonus value.
Scale with Potential: While you can put your own value, the value used in grooves is 13.
Event Idols: While you can put your own value, the value used in grooves is 70.

Values in the grid are automatically updated when you change the number in the box.

Import cards from ID

Put your in-game ID (9 digits) into the box, press “Import from ID”, wait a few seconds and you should see all your cards in the card list.

The tool tries to get your SSRs by accessing the SSR posters you have collected. So if you sold any or haven’t collected all of them from the present box, you might miss some SSRs.

After importing SSRs, you will have to manually add star ranks if you used star rank trainers.

Ns/Rs/SRs are not added for obvious reasons.

Tip view

Periodically displays tips on how to use the tool, as well as notifications.

Potentials

You can change potentials here.

A quick way to navigate this window is to click on the name column and type the first few letters of the idol’s family name, e.g. typing “nino” will move the cursor to Asuka.

Autoplay

In autoplay mode, you can test if your build can survive a full song without you touching your device even once.

The scoring columns will disappear and you will see a few new columns:

Auto Score: The score you get at the end of the song.
Perfects: Total number of perfects.
Misses: Total number of misses.
Max Combo: Highest combo achieved in the autoplay simulation.
Lowest Life: Lowest life hit with the build. Your autoplay will fail in reality if this value is under 0. You can try to offset it by adding more life potentials.
Lowest Life Time (s): The moment when this build hits the lowest life value in the song.
All Skills 100%?: Yes if all your skills have at least 100% chance of activating, else No. If this column is No, your build will not achieve deterministic autoplay outcome, which is a bad thing.

Except “Perfect Simulation” and “--- times”, all other options are usable in Autoplay mode.

Relevant options:

Mirror: Due to a bug in the game, auto builds can have different performance when a chart is mirrored. Use this option to mirror a chart.
Time offset (in the example above, it’s 120ms): This is an auto build concept. Notes are covered by Perfect Support when they hit the bottom of the screen in auto builds. Some people set low scroll values when they auto to increase this offset (since notes fall slower and take longer to hit the bottom of the screen). Check the table below to see what value you should put in this box.

Tested offsets:

Scroll Speed	Offset (ms)	Scroll Speed	Offset (ms)
1	433	6	235
2	400	7	200
3	366	9.6	135
4	300	10	115

For scroll speeds not present, you can make an educated guess (e.g. speed 5 would be around 260ms).

If you want to do extensive testing and contribute to this list, it would be great.