Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xadillax/render-ojn
Renders O2Jam OJN/OJM to MP3/WAV/OGG music file. (Forked from https://github.com/djzmo/render-ojn)
https://github.com/xadillax/render-ojn
Last synced: 28 days ago
JSON representation
Renders O2Jam OJN/OJM to MP3/WAV/OGG music file. (Forked from https://github.com/djzmo/render-ojn)
- Host: GitHub
- URL: https://github.com/xadillax/render-ojn
- Owner: XadillaX
- License: gpl-3.0
- Created: 2015-11-20T05:55:46.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2015-11-26T14:15:13.000Z (almost 9 years ago)
- Last Synced: 2024-10-05T01:54:02.637Z (about 1 month ago)
- Language: C
- Size: 2.79 MB
- Stars: 3
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# RenderOJN #
Renders O2Jam OJN/OJM to MP3/WAV/OGG music file
- **Author**: Yana Nugraha
- **Author Homepage**: http://djzmo.com
- **Forked by**: XadillaX
- **Latest Version**: 0.9.0
--------------------------------------------------------------------------------------------------
This software is provided 'as-is', without any express or implied
warranty. In no event will the authors be held liable for any damages
arising from the use of this software.
## Summary ##
RenderOJN is a utility which is able to render an OJN file into PCM and encode to
preferred audio file format.
See it in action: https://www.youtube.com/watch?v=snYnd_IvmbM
## Usage Notes ##
- In realtime mode, it is HIGHLY recommended to do nothing with your computer
while rendering a keysounded music to preserve output quality.
- In quick mode, output quality might not be satisfying on keysounded music.
## Version History ##
### v0.9.0
Released: Nov 2015
- Make it compilabled under OSX.
### v0.8.2
Released: June 2012
- Able to encode to OGG with automatic tagging.
- Added output quality option.
- Added "Genre" field to the music tag.
- Added application icon.
- Added progress percentage on time-consuming processes.
- Fixed chopped music ending bug.
### v0.8.0
- Able to encode to MP3 with automatic ID3 tagging.
- Keysounded notes might or might not be rendered properly in quick mode.
## Compilation ##
```
$ make
$ sudo make install
```
## Usage ##
Usage: ```ojn_renderer [inputfile [options]]```
Rendering Options:
```
--rendermode Rendering Mode (quick, realtime). Default: quick
--format Output Format (wav, mp3, ogg). Default: mp3
--outfile Output Filename. Default: .
Whitespace is not allowed.
--quality Output Quality (for mp3 and ogg). Default: 3
3 - Best, 2 - Standard, 1 - Poor
```
Misc. Options:
```
--difficulty Note Difficulty (e, n, h). Default: h
--play Play the music instead of generating an output file
--help Display this text
```
Example:
```
ojn_renderer o2ma100.ojn --outfile BachAlive.mp3 --quality 2
ojn_renderer o2ma100.ojn --rendermode realtime --format wav
ojn_renderer o2ma100.ojn --play
ojn_renderer --help
```
## Dependencies ##
- [FMOD Ex Programmer's API version 4](http://fmod.org)
- [libsndfile](https://github.com/erikd/libsndfile)
- [taglib](https://github.com/taglib/taglib)
- [Boost 1.40+](http://boost.org) for Boost Date Time and Program Options
### License ###
This is an open-sourced software licensed under the [GNU GPL v3 license](http://www.gnu.org/licenses/gpl-3.0.en.html).