mirror of
https://github.com/clangen/musikcube.git
synced 2024-11-19 20:13:36 +00:00
94 lines
3.0 KiB
Markdown
94 lines
3.0 KiB
Markdown
# musikcube
|
|
|
|
a cross-platform audio engine and player written in C++.
|
|
|
|
# musikbox
|
|
|
|
an ncurses frontend to musikcube.
|
|
|
|
musicbox compiles and runs easily on Windows, OSX and Linux.
|
|
|
|
it looks something like this on windows:
|
|
|
|
|
|
|
|
and this on osx:
|
|
|
|
|
|
|
|
and linux:
|
|
|
|
|
|
|
|
# compiling
|
|
|
|
## windows
|
|
|
|
- grab the [Visual Studio 2015 Community Edition](https://www.visualstudio.com/en-us/downloads/download-visual-studio-vs.aspx) and install the C++ compiler and tools. the 32-bit compiler is currently used.
|
|
- clone the musikcube sources: `git clone https://github.com/clangen/musikcube.git`
|
|
- install the [32 bit version of boost 1.60](https://sourceforge.net/projects/boost/files/boost-binaries/1.60.0/boost_1_60_0-msvc-14.0-32.exe/download). ensure it shares the same parent directory with musikcube. e.g: `c:\src\musikcube` and `c:\src\boost_1_60_0` -- the project's solution will reference it via relative path.
|
|
- open `musikcube.sln` and build/run.
|
|
|
|
## mac
|
|
|
|
you'll need [homebrew](http://brew.sh/) to install the required dependencies.
|
|
|
|
- `brew install cmake boost libogg libvorbis flac mpg123 faad2 taglib`
|
|
- `git clone https://github.com/clangen/musikcube.git`
|
|
- `cd musikcube`
|
|
- `cmake .`
|
|
- `make`
|
|
- `cd bin`
|
|
- `./musikbox`
|
|
|
|
## linux
|
|
|
|
- install the following libraries and their development packages: `cmake boost libogg vorbis flac mpg123 faad2 taglib`
|
|
- `git clone https://github.com/clangen/musikcube.git`
|
|
- `cd musikcube`
|
|
- `cmake .`
|
|
- `make`
|
|
- `cd bin`
|
|
- `./musikbox`
|
|
|
|
## keyboard shortcuts
|
|
|
|
the current hotkeys are generally based around holding the alt/meta key with your left thumb, and using the home row with your right hand.
|
|
|
|
- `TAB` select next window
|
|
- `SHIFT+TAB` select previous window
|
|
- `ALT+~` switch to console view
|
|
- `ALT+a` switch to library view
|
|
- `ALT+s` switch to settings view
|
|
- `ALT+i` volume up 5%
|
|
- `ALT+k` volume down 5%
|
|
- `ALT+j` previous track
|
|
- `ALT+l` next track
|
|
- `ALT+u` back 10 seconds
|
|
- `ALT+o` forward 10 seconds
|
|
- `ALT+r` repaint the screen
|
|
- `ALT+,` toggle repeat mode (off/track/list)
|
|
- `ALT+.` (un)shuffle play queue
|
|
- `CTRL+p` pause/resume (globally)
|
|
- `CTRL+x` stop (unload streams, free resources)
|
|
- `CTRL+d` quit
|
|
|
|
and a couple hotkeys that are specific to the library view:
|
|
|
|
- `ESC` toggle between browse and play queue
|
|
- `ALT+b` show browse view
|
|
- `ALT+n` show play queue
|
|
- `ALT+f` show album/artist/genre search
|
|
- `ALT+t` show track search
|
|
- `ALT+1` browse by artist
|
|
- `ALT+2` browse by album
|
|
- `ALT+3` browse by genre
|
|
- `ALT+m` jump to playing artist/album/genre in browse view
|
|
- `SPACE` pause/resume
|
|
|
|
*important*: on OSX make sure you configure your terminal emulator to treat your left alt key as "+Esc" or "Meta".
|
|
|
|
# sdk
|
|
|
|
musikcube is built around its own SDK interfaces. they're still in the process of being cleaned up and slimmed down. you can see what they look like here: https://github.com/clangen/musikcube/tree/master/src/core/sdk
|