variabletime/README.md

50 lines
2 KiB
Markdown
Raw Permalink Normal View History

2023-09-24 18:39:52 +02:00
# Variable Time
2023-09-24 21:51:33 +02:00
## Instructions
2023-09-24 18:39:52 +02:00
Instructions on how to use Variable Time are available [here](https://git.pointer.click/variablelab/variabletime/wiki)
2023-09-24 21:51:33 +02:00
## Issues
If you experience issues with Variable Time, please write us at `variabletime at pointer.click`.
2023-09-24 18:39:52 +02:00
2023-09-24 21:51:33 +02:00
## Run
2023-09-24 18:39:52 +02:00
Though it is possible to run this on your own server, we expect that you will probably just want to visit [variable time](https://variabletime.pointer.click)
Should you not be afraid to dive into the mysterious world of developing Variable Time, please go ahead.
2023-09-24 21:51:33 +02:00
### Compile and run
2023-09-24 18:39:52 +02:00
Install all dependencies, then
`$ emmake make && python3 serve.py`
2023-09-24 21:51:33 +02:00
## Dependencies
### Depends on:
2023-09-24 18:39:52 +02:00
- [openFrameworks 0.12.0](https://openframeworks.cc)
- [ofxVariableLab](https://git.pointer.click/variablelab/ofxvariablelab)
- [ofxMsdfgen](https://git.pointer.click/ofxAddons/ofxmsdfgen)
- [ofxGPUFont](https://git.pointer.click/ofxAddons/ofxgpufont)
- [Emscripten SDK](https://github.com/emscripten-core/emsdk)
2023-09-24 21:51:33 +02:00
### Optional:
2023-09-24 18:39:52 +02:00
- [ofxProfiler](https://git.pointer.click/ofxAddons/ofxProfiler)
2024-03-16 13:36:04 +01:00
This allows us to profile the web export in the same way as a desktop export
2023-09-24 18:39:52 +02:00
2023-09-24 21:51:33 +02:00
### Included dependencies:
2023-09-24 18:39:52 +02:00
- [ffmpeg.wasm](https://github.com/ffmpegwasm/ffmpeg.wasm)
- [theatre-js](https://git.pointer.click/variablelab/theatre)
we use a custom fork of [theatre-js](https://theatrejs.com), which is a fantastic animation library and framework
- [miniz](https://github.com/richgel999/miniz)
- [emscripten-browser-file](https://github.com/Armchair-Software/emscripten-browser-file)
2023-09-24 21:51:33 +02:00
## Development notes:
### Https local development
2023-09-24 18:39:52 +02:00
- install [mkcert](https://github.com/FiloSottile/mkcert)
- follow instructions and install certificate file in bin/ssl
2023-09-24 21:51:33 +02:00
### Convenience scripts
2023-09-24 18:39:52 +02:00
`$ ./lightclean.sh && emmake make -j$(nproc) && python3 serve.py`
Note: As we load shaders from external repositories, they need to be copied to the data directory before emscripten compilation. This happens automatically if we delete them first.
2023-09-24 21:51:33 +02:00
### Fonts
2023-09-24 18:39:52 +02:00
Fonts have different licensing and are not included in this repository.