Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bluedaniel/Kakapo-app
:musical_note: [Web & Desktop] An open source ambient sound mixer
https://github.com/bluedaniel/Kakapo-app
desktop electron kakapo react
Last synced: 5 days ago
JSON representation
:musical_note: [Web & Desktop] An open source ambient sound mixer
- Host: GitHub
- URL: https://github.com/bluedaniel/Kakapo-app
- Owner: bluedaniel
- License: gpl-3.0
- Created: 2015-09-17T21:05:40.000Z (about 9 years ago)
- Default Branch: develop
- Last Pushed: 2018-12-03T10:50:54.000Z (almost 6 years ago)
- Last Synced: 2024-08-04T00:02:42.815Z (3 months ago)
- Topics: desktop, electron, kakapo, react
- Language: JavaScript
- Homepage: http://kakapo.co/app.html
- Size: 7.11 MB
- Stars: 389
- Watchers: 16
- Forks: 32
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-starred - bluedaniel/Kakapo-app - :musical_note: [Web & Desktop] An open source ambient sound mixer (react)
README
[](https://travis-ci.org/bluedaniel/Kakapo-app) [](https://david-dm.org/bluedaniel/kakapo-app)
[Kakapo](http://kakapo.co) is an open source ambient sound mixer for relaxation or productivity.
This repo builds a website and desktop version (for Mac OSX & Windows).
[Download the latest desktop version here](http://www.kakapo.co/app.html), or install via [homebrew-cask](http://caskroom.io/) with `brew cask install kakapo`.
See also: [Kakapo for iOS & Android](https://github.com/bluedaniel/Kakapo-native) - [Kakapo for Chrome](https://github.com/bluedaniel/Kakapo-chrome).
It's built using:
- [Electron](https://github.com/atom/electron) - Wraps app for desktop.
- [React](https://github.com/facebook/react) - UI & view components.
- [Redux](https://github.com/rackt/redux) - State management.
- [Redux Sagas](https://github.com/redux-saga/redux-saga) - Handles side effects.
- [Ramda](https://github.com/ramda/ramda) - For functional Javascript.
- [HowlerJs](https://github.com/goldfire/howler.js) - Handles audio objects.
- [ReactIntl](https://github.com/yahoo/react-intl) - Internationalisation.
- [PostCSS](https://github.com/postcss/postcss) - Transform JS styles.
- [Webpack](https://github.com/webpack/webpack) - Bundling JS and hot module replacement.
Tests using [Jest](https://github.com/facebook/jest) and a bit of [Enzyme](https://github.com/airbnb/enzyme).
Code coverage reporting provided by [Coveralls](https://coveralls.io/).
## Install and run
``` bash
# Clone
$ git clone https://github.com/bluedaniel/Kakapo-app.git
# Install
$ cd Kakapo-app && npm install
# Convert .mp3 files to .ogg with ffmpeg
$ brew install ffmpeg --with-libvpx --with-libvorbis
$ cd node_modules/kakapo-assets
$ sh mp3-to-ogg.sh
# Run desktop
$ npm start -- --platform=desktop
# Run website
$ npm start -- --platform=web
```
Both the website and desktop app should automatically open and have hot module enabled for live changes.
## Build for production
``` bash
# Build website
$ npm run build -- --platform=web --production
# Build desktop
$ npm run build -- --platform=desktop --production
# Sign apps and zip after desktop build
$ npm run installer-mac && npm run installer-win
```
## Testing
``` bash
# Test with watch
$ npm test -- --watch
# Test
$ npm test
```
## Bugs and Feature Requests
Have a bug or a feature request? [Please open a new issue here](https://github.com/bluedaniel/Kakapo-app/issues/new).