Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/edubart/seqtoy
Toy music sequencer written in Nelua for RIV fantasy console
https://github.com/edubart/seqtoy
music nelua retro riv rives sequencer
Last synced: 2 months ago
JSON representation
Toy music sequencer written in Nelua for RIV fantasy console
- Host: GitHub
- URL: https://github.com/edubart/seqtoy
- Owner: edubart
- Created: 2024-06-08T18:23:44.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-08-17T18:38:55.000Z (5 months ago)
- Last Synced: 2024-08-17T19:48:03.291Z (5 months ago)
- Topics: music, nelua, retro, riv, rives, sequencer
- Language: Lua
- Homepage: https://emulator.rives.io/#cartridge=https://raw.githubusercontent.com/edubart/cartridges/main/seqtoy.sqfs
- Size: 32.2 KB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Seqtoy
This is a tool for creating small music sequence loops to be used
in small games.
It's written in [Nelua](https://nelua.io/) for [RIV](https://docs.rives.io) fantasy console.
You can try it in your browser
[here](https://emulator.rives.io/#cartridge=https://raw.githubusercontent.com/edubart/cartridges/main/seqtoy.sqfs).
## Sound loop examples
Here is a list of 10 sound loops created with this tool as examples, click on them to play in your browser, you can also mix them right-away.
- [01.seqt.rivcard](https://emulator.rives.io/#cartridge=https://raw.githubusercontent.com/edubart/cartridges/main/seqtoy.sqfs&incard=https://raw.githubusercontent.com/edubart/cartridges/main/cards/01.seqt.rivcard)
- [02.seqt.rivcard](https://emulator.rives.io/#cartridge=https://raw.githubusercontent.com/edubart/cartridges/main/seqtoy.sqfs&incard=https://raw.githubusercontent.com/edubart/cartridges/main/cards/02.seqt.rivcard)
- [03.seqt.rivcard](https://emulator.rives.io/#cartridge=https://raw.githubusercontent.com/edubart/cartridges/main/seqtoy.sqfs&incard=https://raw.githubusercontent.com/edubart/cartridges/main/cards/03.seqt.rivcard)
- [04.seqt.rivcard](https://emulator.rives.io/#cartridge=https://raw.githubusercontent.com/edubart/cartridges/main/seqtoy.sqfs&incard=https://raw.githubusercontent.com/edubart/cartridges/main/cards/04.seqt.rivcard)
- [05.seqt.rivcard](https://emulator.rives.io/#cartridge=https://raw.githubusercontent.com/edubart/cartridges/main/seqtoy.sqfs&incard=https://raw.githubusercontent.com/edubart/cartridges/main/cards/05.seqt.rivcard)
- [06.seqt.rivcard](https://emulator.rives.io/#cartridge=https://raw.githubusercontent.com/edubart/cartridges/main/seqtoy.sqfs&incard=https://raw.githubusercontent.com/edubart/cartridges/main/cards/06.seqt.rivcard)
- [07.seqt.rivcard](https://emulator.rives.io/#cartridge=https://raw.githubusercontent.com/edubart/cartridges/main/seqtoy.sqfs&incard=https://raw.githubusercontent.com/edubart/cartridges/main/cards/07.seqt.rivcard)
- [08.seqt.rivcard](https://emulator.rives.io/#cartridge=https://raw.githubusercontent.com/edubart/cartridges/main/seqtoy.sqfs&incard=https://raw.githubusercontent.com/edubart/cartridges/main/cards/08.seqt.rivcard)
- [09.seqt.rivcard](https://emulator.rives.io/#cartridge=https://raw.githubusercontent.com/edubart/cartridges/main/seqtoy.sqfs&incard=https://raw.githubusercontent.com/edubart/cartridges/main/cards/09.seqt.rivcard)
- [10.seqt.rivcard](https://emulator.rives.io/#cartridge=https://raw.githubusercontent.com/edubart/cartridges/main/seqtoy.sqfs&incard=https://raw.githubusercontent.com/edubart/cartridges/main/cards/10.seqt.rivcard)
## Notes
Have in mind this is a sequencer toy, with emphasis on *toy*,
it's NOT a goal to create a DAW (Digital Audio Workstation).
However this tools is enough to create simple and interesting sound loops
to be used in simple games.
As a toy, it has some intentional constraints to not make its users
overwhelmed by so many options professional music sequencers have,
these are some of them:
- Sequence time span can have at most 112 notes
- Only the notes in the D# Major Pentatonic are available to be played, so each note always sounds nice relative to another note
- Can only have up to 4 pre-defined tracks with predefined instrument synthesizer (Strings, Lead, Bass and Drums)
## Controls
You can only use the keyboard to use this tool.
This is intentionally so it can be used with game pads and also on mobile in the future where there is no mouse.
The keyboard shortcuts are mapped in a way to be compatible with RIV gamepad mappings,
so it can be a bit strange at first but it's a matter of getting used to it.
You can view the controls by holding E or SELECT button gamepad button.
## How it works
It plays simple audio waveforms (Sine, Square, Sawtooth, etc) for the instruments
every frame, check the RIV documentation for more details about waveforms.
## Compiling
First make sure you have the RIV SDK installed in your environment, then just type `make` to compile.
You can also play it by typing `make run`.
## Using in RIV cartridges
Using in other RIV cartridges is easy, you just need to copy [seqt.h](/seqt.h)
to your project and use it.
Check [seqt-example.c](/seqt-example.c) file for an example playing a music.
You can try this example with:
```sh
rivemu -workspace -exec riv-jit-c seqt-example.c
```