brannon-darby/ionic-recorder

Audio sound recording, playback and organizer mobile / browser hybrid app, based on Ionic 2 / Angular 2, Web Audio Api and IndexedDB

ionic-recorder

ionic-recorder is a sound recording hybrid app - "hybrid", meaning the same code works in your browser if served from a web server or as a native app running on any of the platforms: Android, iOS or Windows Phone.

ionic-recorder combines

• Ionic 2
• Web Audio API
• IndexedDB

Features

• Simple interface to record sounds
• Real-time visualizations, stats and data-analysis of incoming audio
• A file/folder music organizer for recordings and links

Project Status

This project is still very much a work in progress.

The recorder app is still in alpha, it does not yet have all features.

System Requirements (for running the app)

This apps runs only in browsers that implement a late version of IndexedDB that supports the onupgradeended event, plus a recent version of the Web Audio Api.

The only browsers on which we successfully tested the above link are:

• Latest Chrome or latest Chromium browser
• Latest Firefox

Live Demo

Unoptimized version at https://tracktunes.org/ionic-recorder

NOTE: Until the official beta release, expect lots of bugs and unimplemented features.

NOTE: The About page shows the version number that's running there, it should be the same as in the [VERSION] (https://github.com/tracktunes/ionic-recorder/blob/master/VERSION) file.

Development

Feel free to work on whatever you like, of course - but there are specific places where we feel we need help and those are all the issues marked with the label 'help wanted' on the issues page. Please refer to the file CONTRIBUTING.md if joining our developer community. Welcome!

Installing the development environment and running from sources

• Install, on your development machine, the latest stable version of the following global packages (the first one may be a system package, the rest are installed via npm -g as they are command-line tool but if you don't like using -g, ensure these command-line tools are on your path):

  • npm
  • Ionic CLI (npm install -g ionic@beta)
  • Cordova (npm install -g cordova)
  • Webdriver (npm install -g webdriver-manager)
  • node (npm install -g node)

• Clone the repository and cd into it

    git clone https://github.com/tracktunes/ionic-recorder
    cd ionic-recorder
  

• Install the npm packages needed by this project

    npm install
  

This last command also performs some postinstall actions.

• You can develop now. As usual, all the code is under subdirectory './app'. Useful commands from 'package.json':

    npm start
  

which starts a server and pops up a browser tab with the app running in it, or

    npm test

which runs through the unit tests.

Version

The current version is maintained in the VERSION file.

The version in this file corresponds to a git tag by the same name, with a 'v' prefix added in the git tag name.

License

This software is licensed under the GNU General Public License, version 2 (GPL-2.0)

Copyright

Copyright (C) 2017 Tracktunes Inc. (tracktunes.org)