README principal: la documentacion del fork con los enlaces
El README que renderiza Gitea es ahora el del hacklab (que anade el fork, instalacion, samples, algorave y demas enlaces). El original de Strudel queda intacto en README-upstream.md.
This commit is contained in:
hacklab
parent
921647020c
commit
fcfc1b784f
3 changed files with 116 additions and 40 deletions
52
README-upstream.md
Normal file
52
README-upstream.md
Normal file
|
|
@ -0,0 +1,52 @@
|
||||||
|
# strudel
|
||||||
|
|
||||||
|
Live coding patterns on the web
|
||||||
|
|
||||||
|
|
||||||
|
- Try it here: <https://strudel.cc>
|
||||||
|
- Docs: <https://strudel.cc/learn>
|
||||||
|
- Source: https://codeberg.org/uzu/strudel/
|
||||||
|
* Along with many other live coding projects, we have moved from Microsoft's Github platform to Codeberg for ethical reasons. **Please don't fork the project back to github**.
|
||||||
|
- Technical Blog Post: <https://loophole-letters.vercel.app/strudel>
|
||||||
|
- 1 Year of Strudel Blog Post: <https://loophole-letters.vercel.app/strudel1year>
|
||||||
|
- 2 Years of Strudel Blog Post: <https://strudel.cc/blog/#year-2>
|
||||||
|
|
||||||
|
|
||||||
|
## Running Locally
|
||||||
|
|
||||||
|
After cloning the project, you can run the REPL locally:
|
||||||
|
|
||||||
|
1. Install [Node.js](https://nodejs.org/) 18 or newer
|
||||||
|
2. Install [pnpm](https://pnpm.io/installation)
|
||||||
|
3. Install dependencies by running the following command:
|
||||||
|
```bash
|
||||||
|
pnpm i
|
||||||
|
```
|
||||||
|
4. Run the development server:
|
||||||
|
```bash
|
||||||
|
pnpm dev
|
||||||
|
```
|
||||||
|
|
||||||
|
## Using Strudel In Your Project
|
||||||
|
|
||||||
|
This project is organized into many [packages](./packages), which are also available on [npm](https://www.npmjs.com/search?q=%40strudel).
|
||||||
|
|
||||||
|
Read more about how to use these in your own project [here](https://strudel.cc/technical-manual/project-start).
|
||||||
|
|
||||||
|
You will need to abide by the terms of the [GNU Affero Public Licence v3](LICENSE). As such, Strudel code can only be shared within free/open source projects under the same license -- see the license for details.
|
||||||
|
|
||||||
|
Licensing info for the default sound banks can be found over on the [dough-samples](https://github.com/felixroos/dough-samples/blob/main/README.md) repository.
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
|
||||||
|
There are many ways to contribute to this project! See [contribution guide](./CONTRIBUTING.md). You can find the full list of contributors [here](https://codeberg.org/uzu/strudel/activity/contributors).
|
||||||
|
|
||||||
|
## Community
|
||||||
|
|
||||||
|
There is a #strudel channel on the TidalCycles discord: <https://discord.com/invite/HGEdXmRkzT>
|
||||||
|
|
||||||
|
You can also ask questions and find related discussions on the tidal club forum: <https://club.tidalcycles.org/>
|
||||||
|
|
||||||
|
The discord and forum is shared with the haskell (tidal) and python (vortex) siblings of this project.
|
||||||
|
|
||||||
|
We also have a mastodon account: <a rel="me" href="https://social.toplap.org/@strudel">social.toplap.org/@strudel</a>
|
||||||
102
README.md
102
README.md
|
|
@ -1,57 +1,81 @@
|
||||||
# strudel
|
# Strudel · fork del hacklab
|
||||||
|
|
||||||
> **Fork del hacklab** con interfaz multiidioma, pestaña de proyectos, barra
|
Fork de [Strudel](https://codeberg.org/uzu/strudel) (live coding de música en
|
||||||
> de transporte con seek, guía de sonidos y lanzador de escritorio.
|
el navegador, port de TidalCycles a JavaScript) con mejoras de usabilidad para
|
||||||
> Ver [README-HACKLAB.md](./README-HACKLAB.md). Upstream:
|
pinchar en directo. Misma licencia que upstream: AGPL-3.0 (ver `LICENSE`).
|
||||||
> <https://codeberg.org/uzu/strudel>
|
|
||||||
|
|
||||||
Live coding patterns on the web
|
## Qué añade
|
||||||
|
|
||||||
|
- Interfaz multiidioma (castellano, inglés, francés, alemán, italiano,
|
||||||
|
portugués y más). Selector en el header.
|
||||||
|
- Pestaña Projects: proyectos locales con carpetas, buscador y una librería
|
||||||
|
de tracks de fábrica para empezar a pinchar.
|
||||||
|
- Barra de transporte bajo el editor: anterior / play-pausa / siguiente,
|
||||||
|
tiempo y barra de progreso arrastrable (seek real sobre el reloj del
|
||||||
|
scheduler). Al cargar un track el loop arranca desde cero; editar y
|
||||||
|
actualizar en vivo no reinicia nada.
|
||||||
|
- Pestaña Guía: chuleta de síntesis y sonidos.
|
||||||
|
- Packs de temas del editor: neon-madrid y hacklab-pack.
|
||||||
|
- Lanzador de escritorio: `strudel-launcher.sh`.
|
||||||
|
|
||||||
- Try it here: <https://strudel.cc>
|
## Instalación (Linux)
|
||||||
- Docs: <https://strudel.cc/learn>
|
|
||||||
- Source: https://codeberg.org/uzu/strudel/
|
|
||||||
* Along with many other live coding projects, we have moved from Microsoft's Github platform to Codeberg for ethical reasons. **Please don't fork the project back to github**.
|
|
||||||
- Technical Blog Post: <https://loophole-letters.vercel.app/strudel>
|
|
||||||
- 1 Year of Strudel Blog Post: <https://loophole-letters.vercel.app/strudel1year>
|
|
||||||
- 2 Years of Strudel Blog Post: <https://strudel.cc/blog/#year-2>
|
|
||||||
|
|
||||||
|
Requisitos: `git`, `node` >= 20 y `pnpm` (`corepack enable`).
|
||||||
|
|
||||||
## Running Locally
|
```bash
|
||||||
|
git clone https://gitea.laenre.net/hacklab/strudel.git
|
||||||
|
cd strudel
|
||||||
|
pnpm i
|
||||||
|
```
|
||||||
|
|
||||||
After cloning the project, you can run the REPL locally:
|
Desarrollo (recarga en vivo):
|
||||||
|
|
||||||
1. Install [Node.js](https://nodejs.org/) 18 or newer
|
```bash
|
||||||
2. Install [pnpm](https://pnpm.io/installation)
|
pnpm dev # http://localhost:4321
|
||||||
3. Install dependencies by running the following command:
|
```
|
||||||
```bash
|
|
||||||
pnpm i
|
|
||||||
```
|
|
||||||
4. Run the development server:
|
|
||||||
```bash
|
|
||||||
pnpm dev
|
|
||||||
```
|
|
||||||
|
|
||||||
## Using Strudel In Your Project
|
Uso diario (build estática + lanzador):
|
||||||
|
|
||||||
This project is organized into many [packages](./packages), which are also available on [npm](https://www.npmjs.com/search?q=%40strudel).
|
```bash
|
||||||
|
pnpm build
|
||||||
|
./strudel-launcher.sh # sirve http://127.0.0.1:3009 y abre el navegador
|
||||||
|
```
|
||||||
|
|
||||||
Read more about how to use these in your own project [here](https://strudel.cc/technical-manual/project-start).
|
Icono de escritorio: `~/.local/share/applications/strudel.desktop`
|
||||||
|
|
||||||
You will need to abide by the terms of the [GNU Affero Public Licence v3](LICENSE). As such, Strudel code can only be shared within free/open source projects under the same license -- see the license for details.
|
```ini
|
||||||
|
[Desktop Entry]
|
||||||
|
Type=Application
|
||||||
|
Name=Strudel
|
||||||
|
Comment=Live coding de musica
|
||||||
|
Exec=/ruta/a/strudel/strudel-launcher.sh
|
||||||
|
Icon=audio-x-generic
|
||||||
|
Terminal=false
|
||||||
|
Categories=AudioVideo;Audio;
|
||||||
|
```
|
||||||
|
|
||||||
Licensing info for the default sound banks can be found over on the [dough-samples](https://github.com/felixroos/dough-samples/blob/main/README.md) repository.
|
## Packs de proyectos propios
|
||||||
|
|
||||||
## Contributing
|
La librería de fábrica está en
|
||||||
|
`website/src/repl/components/panel/default-projects.mjs`. Para un pack
|
||||||
|
personal crea un módulo con el mismo formato `{name, folder, code}` y
|
||||||
|
concaténalo en `DEFAULT_PROJECTS` (los packs personales están en
|
||||||
|
`.gitignore`). También se pueden crear proyectos desde la propia pestaña.
|
||||||
|
|
||||||
There are many ways to contribute to this project! See [contribution guide](./CONTRIBUTING.md). You can find the full list of contributors [here](https://codeberg.org/uzu/strudel/activity/contributors).
|
## Actualizar desde upstream
|
||||||
|
|
||||||
## Community
|
```bash
|
||||||
|
git fetch upstream
|
||||||
|
git merge upstream/main
|
||||||
|
```
|
||||||
|
|
||||||
There is a #strudel channel on the TidalCycles discord: <https://discord.com/invite/HGEdXmRkzT>
|
## Enlaces
|
||||||
|
|
||||||
You can also ask questions and find related discussions on the tidal club forum: <https://club.tidalcycles.org/>
|
- Strudel (upstream): <https://codeberg.org/uzu/strudel> — su README original: [README-upstream.md](./README-upstream.md)
|
||||||
|
- Documentación / tutorial: <https://strudel.cc/learn>
|
||||||
The discord and forum is shared with the haskell (tidal) and python (vortex) siblings of this project.
|
- TidalCycles, el original en Haskell: <https://tidalcycles.org>
|
||||||
|
- Algorave, la escena: <https://algorave.com>
|
||||||
We also have a mastodon account: <a rel="me" href="https://social.toplap.org/@strudel">social.toplap.org/@strudel</a>
|
- Samples para empezar a jugar:
|
||||||
|
- Dirt-Samples (la librería clásica de Tidal): <https://github.com/tidalcycles/Dirt-Samples>
|
||||||
|
- tidal-drum-machines (Roland TR-808/909 y muchas más): <https://github.com/ritchse/tidal-drum-machines>
|
||||||
|
- Para ver de qué va esto en directo: <https://www.youtube.com/watch?v=iu5rnQkfO6M>
|
||||||
|
|
|
||||||
|
|
@ -6,7 +6,7 @@
|
||||||
# ./strudel-launcher.sh # puerto 3009
|
# ./strudel-launcher.sh # puerto 3009
|
||||||
# STRUDEL_PORT=4000 ./strudel-launcher.sh
|
# STRUDEL_PORT=4000 ./strudel-launcher.sh
|
||||||
#
|
#
|
||||||
# Requiere haber hecho antes: pnpm i && pnpm build (ver README-HACKLAB.md)
|
# Requiere haber hecho antes: pnpm i && pnpm build (ver README.md)
|
||||||
set -u
|
set -u
|
||||||
|
|
||||||
DIR="$(cd "$(dirname "$0")" && pwd)"
|
DIR="$(cd "$(dirname "$0")" && pwd)"
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue