Toolbox for manipulating the JSON-Format used by Synth Riders Beatmap Editor in the clipboard
Project description
Synth Mapping Helper
Toolbox for manipulating the JSON-Format used by Synth Riders Beatmap Editor in the clipboard.
Features
- Filter by note and wall types for all operations
- Changing colors
- Change BPM indepenent of note timing
- Movement in XY and Time:
Note: All operation can be done in regards to grid center, a pivot point, or the start of rails- Rotate
- Scale and mirror
- Outset (moving outwards/away by a fixed distance)
- Offset (Translate/Move)
- Pattern generation
- Spirals/Zigzags
- Spike/Buzz-Rails
- Stacking patterns with movement
- Rail manipulation
- Merging
- Splitting
- Interpolation
- Convert between single notes and rails
- Cross-Platform (Windows, Linux)
- For Windows, supports drag and drop actions (fully usable without command prompt)
- Imports directly from clipboard, and export to it
- Uses an internal format that is easy to work with:
- Position in editor grid coordinates (+x=right, +y=up)
- Time in measures (starting from start of selection)
- Angles in degrees (positive=counterclockwise)
- Notes/Rails seperated by color and as
n x 3
numpy-arrays (x, y, time) - Walls as
1 x 5
numpy-arrays (x, y, time, type, rotation) - Walls positions are adjusted to match their rotation center
Maybe
- GUI
- Momentum analysis
- Automatic smoothing
How to Install and use
Advanced users
- Install via
pip3 install synth_mapping_helper
(requires python 3.9 or higher) - See
python3 -m synth_mapping_helper.cli -h
for usage - Feel free to experiment with extending functionality by using the module functions directly. If you have something that you think could help other mappers, please make a PR
Windows
Installation:
- Install Python 3.10 via the store: https://apps.microsoft.com/store/detail/python-310/9PJPW5LDXLZ5
- Download the
windows_helpers.zip
from the releases page - Extract it somewhere
- Double-click
install.bat
to download the library and dependencies
Updating:
- Optional: Download
windows_helpers.zip
again (backup your custom actions before you overwrite) - Run
install.bat
again
Usage:
- Copy the notes from the editor with CTRL-C
- Drag an action text file like
merge_rails.txt
orspiralize.txt
ontosmh.bat
to execute. - Paste the result into the editor with CTRL-V
Making your own actions:
- Run
show_help.bat
to learn which options are supported - You can specify multiple different operations in the same line, they will be chained in the order they appear in the help (ordering of options in the line has no effect).
- If you want a different order, or want to do the same operation multiple times (ie different offsets for two colors), each action file can contain multiple lines which are executed in sequence
- Each line is an independent command, so ie a pivot specified in the first line does not affect the second lines
- If you made a particularly useful action, feel free to share it so it can be added to the examples
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
synth_mapping_helper-0.7.0.tar.gz
(15.5 kB
view hashes)
Built Distribution
Close
Hashes for synth_mapping_helper-0.7.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | e8411874b870290f0591ae43856ba91be388d6797e96495a10709b161606c315 |
|
MD5 | bfe8fef8b2636282974e334480bb7a1f |
|
BLAKE2b-256 | 2b98d8e5306522573a3cbe2898b6bf1c0e6255280cadc8ebe4172e01226d9a33 |
Close
Hashes for synth_mapping_helper-0.7.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 07b484d480c0c7d21cc9945b9215c78367a6148595144fba041eb7196dcd5b63 |
|
MD5 | 13a56599087f31002312851273f5e58e |
|
BLAKE2b-256 | 78233a47799893edc10ae4e45d47895d40787c14baff2a765a01137cffb31fe9 |