Skip to content

Commit

Permalink
Improve readme
Browse files Browse the repository at this point in the history
  • Loading branch information
MaddyGuthridge committed Jan 10, 2024
1 parent 444ba8c commit 12e6b1a
Show file tree
Hide file tree
Showing 3 changed files with 17 additions and 14 deletions.
27 changes: 15 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,23 +2,26 @@

Remotely control FL Studio using the MIDI Controller Scripting API

```py
$ flapi
>>> import ui
>>> ui.setHintMsg("Hello from Flapi!")
# Hint message "Hello from Flapi!" is displayed in FL Studio
```

## Setup

TODO: Document this
1. Install the Flapi library using Pip, or any package manager of your choice.
`pip install flapi`

## Todo
2. Install the Flapi server to FL Studio by running `flapi install`. If you
have changed your FL Studio user data folder, you will need to enter it.

This project is currently not in a functional state. Before the first release I
will.
On Windows, install a virtual MIDI loopback tool such as
[loopMIDI](https://www.tobias-erichsen.de/software/loopmidi.html) and use it to
create a virtual MIDI port named `Flapi`.

- [ ] Tidy up code to make it more readable
- [ ] Make it host its own virtual MIDI device (to avoid the need to install
LoopMIDI)
- [ ] Write documentation
- [ ] Add shell commands
- [ ] `flapi`: run a Python shell with `flapi` enabled
- [ ] `flapi install`: install the `Flapi Server` script in FL Studio
- [ ] `flapi uninstall`: remove the `Flapi Server` script from FL Studio
On MacOS, Flapi is able to create this MIDI port automatically.

## Credits

Expand Down
2 changes: 1 addition & 1 deletion flapi/script/__consts.py
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
Constants used by Flapi
"""

VERSION = (0, 0, 1)
VERSION = (0, 1, 0)
"""
The version of Flapi in the format (major, minor, revision)
"""
Expand Down
2 changes: 1 addition & 1 deletion flapi/script/device_flapi_server.py
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@

def OnInit():
print("Flapi server")
print(f"v{'.'.join(str(n) for n in consts.VERSION)}")
print(f"Server version: {'.'.join(str(n) for n in consts.VERSION)}")
print(f"Device name: {device.getName()}")
print(f"Device assigned: {bool(device.isAssigned())}")
print(f"FL Studio port number: {device.getPortNumber()}")
Expand Down

0 comments on commit 12e6b1a

Please sign in to comment.