mirror of
https://github.com/cyberboy666/r_e_c_u_r.git
synced 2025-12-11 19:00:04 +01:00
77 lines
3.6 KiB
Markdown
77 lines
3.6 KiB
Markdown
# how to use r_e_c_u_r
|
|
|
|
## getting started
|
|
|
|
- insert a usb with some videos you want to sample
|
|
- connect the hdmi output to the display you want to use
|
|
- power the raspberry pi. you should see red lights on the pi board, some boot text on the hdmi out and the lcd display light up
|
|
- after a few moments , a video should play on the display output , the raspberian desktop will load on lcd and then (after a few moments) the r_e_c_u_r display will load
|
|
- the `DSPLY` key can be used to cycle through _display_modes_
|
|
|
|
## controls
|
|
|
|
(put picture with controls here...)
|
|
|
|
the controls on r_e_c_u_r work by mapping `keys` to `actions`. (custom mappings ?) by default most keys map to the same action independent of the state (ie display mode) the r_e_c_u_r is in.
|
|
|
|
The exceptions to this are the control keys:
|
|
|
|
- `<` and `>` : used for navigation when applicable (see below) ; used for seeking current sample in `SAMPLER` mode
|
|
- `■` : used as 'enter' for navigation ; used to toggle pause/play in `SAMPLER` mode.
|
|
|
|
the display modes described below are cycled by using the `DSPLY` key. some actions are accessible through a `FN` layer, toggled by the corresponding key.
|
|
other controls include:
|
|
|
|
- `→` is used to trigger the next loaded sample to play
|
|
- loading the sample in slot `x` to play next; where `x` is a key from `0` to `9`
|
|
- cropping the current sample to start (`[`) or end (`]`) at the current time
|
|
- cycling forward back (`PRV BNK`) or (`NXT BNK`) through the banks of sample , or clearing a bank (`CLR BNK`) (note not implemented yet)
|
|
- `< SPD` and `> SPD` are used to decrease and increase the speed of the currently playing clip (note not implemented yet)
|
|
|
|
some keys are empty to leave room for future features. i encourage you to make a custom key map (link to doc) or add actions (another link) you would like to use.
|
|
|
|
## parts of the lcd display
|
|
|
|
![display_image][display_image]
|
|
|
|
## `PLAYER` display
|
|
|
|
![player_example][player_example]
|
|
|
|
this section displays information about what is in the video player : the position from start and end of currently playing video, what [slot] is playing now and what slot is loaded [next]
|
|
|
|
## `BROWSER` display mode
|
|
|
|
![browser_example][browser_example]
|
|
|
|
this is where you can load samples from your usb into the `SAMPLER`
|
|
|
|
- in this mode , the `<` and `>` keys will move the selection up and down
|
|
- folders are displayed ending in `|` for closed and `/` for open , the depth is displayed as indentation
|
|
- pressing the `■` key while a folder is selected toggles it open/closed
|
|
- pressing the `■` key while a video is selected loads it into the next available slot (note : you can see the first slot a video is loaded into on right column)
|
|
|
|
## `SAMPLER` display mode
|
|
|
|
![sampler_example][sampler_example]
|
|
|
|
this is the main display mode for using r_e_c_u_r. from this view you can see details of all the samples loaded into the sampler. a `bank` contains 10 `slots` labelled `0` - `9`. pressing the corresponding `key` will load the `sample` in this `slot` to start when the current sample finishes. the `slot` of the currently playing sample is highlighted.
|
|
|
|
## `SETTINGS` display mode
|
|
|
|
![settings_example][settings_example]
|
|
|
|
this is where you can configure r_e_c_u_r's settings.
|
|
|
|
- navigate the menu with `<` and `>` keys like about
|
|
- pressing `■` on a setting will either cycle through it's `options` or run an `action` depending on its type (an `action` setting will always have value `run_action`)
|
|
|
|
## `MESSAGE DISPLAY`
|
|
|
|
(put image and info here)
|
|
|
|
[display_image]: display_parts.jpg
|
|
[player_example]: player_example.jpg
|
|
[browser_example]: browser_example.jpg
|
|
[sampler_example]: sampler_example.jpg
|
|
[settings_example]: settings_example.jpg |