Skip to main content

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

  • Movement in XY and Time:
    • Translation
    • Rotation
    • Scaling / Mirroring
  • Changing colors
  • Pattern generation
    • Spirals/Zigzags
    • Spike/Buzz-Rails
  • Rail manipulation
    • Merging
    • Splitting
    • Interpolation
  • 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

Planned Features

  • Support for walls
  • Tiling/Stacking operations

Maybe

  • GUI
  • Smoothing
  • Momentum analysis

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:

Usage:

  • Copy the notes from the editor
  • Drag an action text file like merge_rails.txt or spiralize.txt onto smh.bat to execute.
  • Paste the result into the editor

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


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.3.0.tar.gz (10.9 kB view hashes)

Uploaded Source

Built Distribution

synth_mapping_helper-0.3.0-py3-none-any.whl (10.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page