Skip to main content

A pythonic wrapper for REAPER's ReaScript Python API

Project description

reapy

reapy is a nice pythonic wrapper around the quite unpythonic ReaScript Python API for REAPER.

Contents

  1. Installation
  2. Usage
  3. Contributing
  4. Author
  5. License

Installation

  1. First install from pip:
pip install python-reapy
  1. Run:
python -m reapy

Paths to your Python DLL and to reapy configuration scripts get printed.

  1. If you haven't enabled Python in REAPER yet, go to Options > Preferences... > Plug-ins > ReaScript. Check Enable Python for use with ReaScript, and fill Custom path to Python dll directory and Force ReaScript to use specific Python .dll with the directory path and the file name of the Python DLL.

  2. Enable reapy dist API by running the corresponding ReaScript (Actions > Show action list > Reascript : Load... and browse for the script path).

You're all set! You can now import reapy from inside or outside REAPER as any standard Python module.

Instead of creating a new ReaScript containing:

from reaper_python import *
RPR_ShowConsoleMsg("Hello world!")

you can open your usual Python shell and type:

>>> import reapy
>>> reapy.print("Hello world!")

Usage

ReaScript API

All ReaScript API functions are available in reapy in the sub-module reapy.reascript_api. Note that in ReaScript Python API, all function names start with "RPR_". That unnecessary pseudo-namespace has been removed in reapy. Thus, you shall call reapy.reascript_api.GetCursorPosition in order to trigger reaper_python.RPR_GetCursorPosition. See example below.

>>> from reapy import reascript_api as RPR
>>> RPR.GetCursorPosition()
0.0
>>> RPR.SetEditCurPos(1, True, True)
>>> RPR.GetCursorPosition()
1.0

Note that if you have the SWS extension installed, the additional ReaScript functions it provides will be available in reapy.reascript_api and usable inside and outside REAPER as well.

reapy API

The purpose of reapy is to provide a more pythonic API as a substitute for ReaScript API. Below is the reapy way of executing the example above.

>>> import reapy
>>> project = reapy.Project() # Current project
>>> project.cursor_position
0.0
>>> project.cursor_position = 1
>>> project.cursor_position
1.0

The translation table matches ReaScript functions with their reapy counterparts.

Performance

When used from inside REAPER, reapy has almost identical performance than native ReaScript API. Yet when it is used from the outside, the performance is quite worse. More precisely, since external API calls are processed in a defer loop inside REAPER, there can only be around 30 to 60 of them per second. In a time-critical context, you should make use of the reapy.inside_reaper context manager.

>>> import reapy
>>> project = reapy.Project() # Current project
>>> # Unefficient (and useless) call
>>> bpms = [project.bpm for _ in range(1000)] # Takes at least 30 seconds...
>>> # Efficient call
>>> with reapy.inside_reaper():
...     bpms = [project.bpm for _ in range(1000)]
...
>>> # Takes only 0.1 second!

Documentation

Check the documentation and especially the API guide and Translation Table for more information.

Contributing

For now, about a half of ReaScript API has a reapy counterpart, the docs are far from great, and many bugs are waiting to be found. Feel free to improve the project by checking the contribution guide!

Author

Roméo Després - RomeoDespres

License

This project is licensed under the MIT License - see the LICENSE.txt file for details.

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

python-reapy-0.7.2.tar.gz (202.5 kB view details)

Uploaded Source

Built Distribution

python_reapy-0.7.2-py2.py3-none-any.whl (330.9 kB view details)

Uploaded Python 2Python 3

File details

Details for the file python-reapy-0.7.2.tar.gz.

File metadata

  • Download URL: python-reapy-0.7.2.tar.gz
  • Upload date:
  • Size: 202.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.2

File hashes

Hashes for python-reapy-0.7.2.tar.gz
Algorithm Hash digest
SHA256 2883d3627e2c76a2a93ade613bdb0244109444d7e645c6cbaac89dc1d674252d
MD5 bb6432440af466436be907447f4a7f34
BLAKE2b-256 087503fd5bf2522c8ffa7f72dba28b609f938b5e92e3f4e641638f98de6e4b16

See more details on using hashes here.

File details

Details for the file python_reapy-0.7.2-py2.py3-none-any.whl.

File metadata

  • Download URL: python_reapy-0.7.2-py2.py3-none-any.whl
  • Upload date:
  • Size: 330.9 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.2

File hashes

Hashes for python_reapy-0.7.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 e3f72932ddd160d6a2cc55a7efff4c946ce33f6db368c19d9a67d355f3066618
MD5 b876a5cb8dd48ee7e058b5b7f2c1dfc1
BLAKE2b-256 7163a1a29d3db1f7c58f435a3e1dbe71ead5e9c98894fa68e99a18fa53a18a1c

See more details on using hashes here.

Supported by

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