{"_id":"10er10","_rev":"5-617adb526cf01ab8c3c23fbee4b2435d","name":"10er10","description":"10er10 is an HTML5 audio jukebox. It works on Firefox 4+ and Chromium/Chrome.","dist-tags":{"latest":"0.23.0"},"versions":{"0.23.0":{"name":"10er10","version":"0.23.0","description":"10er10 is an HTML5 audio jukebox. It works on Firefox 4+ and Chromium/Chrome.","main":"node/server.js","engines":{"node":">=0.8"},"directories":{"doc":"doc"},"repository":{"type":"git","url":"https://github.com/dready92/10er10"},"author":{"name":"Michael Bailly","email":"mickael.bailly@free.fr"},"bugs":{"url":"https://github.com/dready92/10er10/issues"},"dependencies":{"qs":"~0.6.5","debug":"~0.7.2","mime":"~1.2.11","gm":"~1.13.1","ws":"~0.4.31","musicmetadata":"~0.2.5","mmmagic":"~0.3.4","prompt":"~0.2.11","nodemailer":"~0.5.3","connect":"~2.9.0","ncouch":">=1.0.0"},"readme":"10er10 is an HTML5 audio jukebox. It works on Firefox 4+ and Chromium/Chrome.\n\nInstall\n=======\n\nInstall servers\n---------------\n\n* CouchDB : the safe way is to install CouchDB by downloading the CouchBase Server ( http://www.couchbase.com/ ). You can also try from source ( http://couchdb.apache.org ), or via your package manager.\n\nMinimum required version : 1.0.1\n\n* Node.js : install node.js ( http://nodejs.org ) from source or with your package manager.\n\nMinimum required version : 0.6.0\n\nDon't forget to add the node binary's folder to the path of the Unix user which will run 10er10.\n\nDebian squeeze users, using the nodejs deb package : you should create a symlink from /usr/lib/nodejs to /usr/lib/node for connect to work.\n\n* NPM : install the Node package manager ( http://npmjs.org ). As of node.js 0.6.3, NPM is now included: no more need to install it !\n\n\nHint : **curl http://npmjs.org/install.sh | sh**\n\nPlease check that your npm version (using the command **npm -v**) is >= 1.0.0 .\n\nInstall audio utilities\n-----------------------\n\n10er10 website allows you to upload flac, mp3, m4a and ogg audio files. Flac, mp3 and m4a files will be converted on the fly to ogg.\n\n* install **lame** executable : it's certainly is available from your distribution packages\n\n* install **oggenc** executable : it's certainly is available from your distribution packages\n\n* install **ogginfo** executable : it's certainly available from your distribution packages\n\n* install **vorbiscomment** executable : it's certainly available from your distribution packages\n\n* install **flac** executable : it's certainly available from your distribution packages\n\n* install **faad** executable : it's certainly available from your distribution packages\n\nInstall graphics utilities\n---------------------------\n\n10er10 website allows you to upload images related to songs (eg. album artwork).\n\n* install **GraphicsMagick** executables : it's certainly available from your distribution packages\n\nAbout 10er10 running environments\n---------------------------------\n\n10er10 got two distinct environments : dev and prod. The main difference is that, in the prod environment, all static files are cached by the node.js server (so they are read only once from the filesystem).\n\n10er10 dev HTTP port is 8888. 10er10 prod HTTP port is 8124.\n\nInstall 10er10 files & required node modules\n--------------------------------------------\n\nUnzip/tar your 10er10 download.\n\ncd to the 10er10 root directory (the one that contains the *audio*, *node* and *views* folders).\n\n* node modules : install required node packages :\n\n        npm install\n\nYou should now have a new **node_modules** folder at the same level as the \"audio\", \"node\" and \"views\" folders.\n\nConfigure 10er10\n----------------\n\nBeginning from 0.6, the preferred way to tweak the configuration is to create a new file **node/config.local.js** and put the settings you want to overwrite.\n\nExample : if you need to set the path where audio file are stored to */some/where/on/the/disk*, open **node/config.local.js** and define the variable inside: like :\n\n    exports.audio = { dir: \"/some/where/on/the/disk\" };\n\nDoing this, your configuration will be kept when you upgrade your 10er10 server.\n\nOpen **node/config.js**\n\n* setup your databases configuration\n\n10er10 uses 4 couchdb databases. Look at **exports.couch_prod** and **exports.couch_dev** objects, and be sure to point the DSN to your CouchDB server. Databases will be created by the installer.\n\n* configure audio path\n\n10er10 needs two distinct folders to store audio files: \n\n\n- exports.audio.tmpdir : the temporary folder is where the uploaded files are stored\n- exports.audio.dir : this is where the ogg files are stored. \n\nOf course, those two folders should be writable by the unix user that will launch the node server.\n\n* configure images path\n\n10er10 needs two distinct folders to store images:\n\n- exports.images.tmpdir : the temporary folder is where the uploaded files are stored (could be the same than exports.audio.tmpdir)\n- exports.images.dir : this is where the images are stored. \n\n\n* about audio URI\n\n**exports.audio_root** is used by the browser to know where is the path to the audio files. If your 10er10 root is \"/\", then the audio_root is \"/audio\". If your 10er10 root is \"/somewhere/10er10\", set audio_root to \"/somewhere/10er10/audio\". You can also set the complete URL ( eg http://my.domain.com/10er10/audio ). Unless you're behind a reverse proxy and you know what you're doing, don't change this setting.\n\n\n* configure Unix utilities\n\nLook at exports.cmds.\n\n- exports.cmds.lame : the path to the lame executable\n- exports.cmds.oggenc : the path to the oggenc executable\n- exports.cmds.ogginfo : the path to the ogginfo executable\n- exports.cmds.vorbiscomment : the path to the vorbiscomment executable\n- exports.cmds.flac : the path to the flac executable\n- exports.cmds.faad : the path to the faad executable\n\nStill here ? Let's go for the fun part.\n \nLaunch the installer\n--------------------\n\ngo into the node/install directory and run the installer.js script.\n\nTo setup dev databases:\n\n    cd node/install\n    node install.js\n\nTo setup prod databases:\n\n    cd node/install\n    node install.js -p\n\n\nCreate a 10er10 user\n--------------------\n\nGo into the node/admin directory and run the d10-createUser.js script.\n\nThe password should be hard enough, or the account won't be created. (at least 8 characters, at least 4 distinct characters).\n\nWon't work :\n\n    test\n    xxxxxxxx\n\n\n\nTo create a user on dev install :\n\n    cd node/admin\n    node d10-createUser.js login thepassword\n\nTo create a user on prod install :\n\n    cd node/admin\n    node d10-createUser.js login thepassword -p\n\nLaunch the server\n-----------------\n\nGo into the node directory and run the server.js script :\n\nTo launch the dev instance :\n\n    cd node\n    node server.js\n\nTo launch the prod instance :\n\n    cd node\n    node server.js -p\n\n\nYou can fire you browser and go to http://[your server]:8888/ if you launched the dev instance, http://[your server]:8124/ if you launched the prod server.\n\nBonus: Configure your invites server\n------------------------------------\n\nYou want to send some friends an email so they can create an account on your 10er10 server and start using the application ? The doc folder contains a file to help you configure invites server.\n\n\nWhat else ?\n-----------\n\nFork, patch, send pull requests !\n\nFollow 10er10 development : https://plus.google.com/u/0/b/109983204693472020055/\n","readmeFilename":"README.md","_id":"10er10@0.23.0","dist":{"shasum":"e017adba21fdb53a8931beb190c3245a6215b07e","tarball":"https://registry.npmjs.org/10er10/-/10er10-0.23.0.tgz","integrity":"sha512-Ch185by4xEp5QzogXGtZZEjffrSgp4R6BblVanEz1YHeep5x80VmRFFhnImqeRRoYchiJXiQE7Rb4gmJ8RwsvA==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIAd2xmqQxWOop5nHXXVwE56XcU5/kzkA9VFFp4oUX4+PAiAD9J/R5aXV7FybK1KZUMiGC8nNtP66acZJN/mBP3qNBA=="}]},"_from":".","_npmVersion":"1.3.11","_npmUser":{"name":"michael_bailly","email":"mickael.bailly@free.fr"},"maintainers":[{"name":"michael_bailly","email":"mickael.bailly@free.fr"}]}},"readme":"10er10 is an HTML5 audio jukebox. It works on Firefox 4+ and Chromium/Chrome.\n\nInstall\n=======\n\nInstall servers\n---------------\n\n* CouchDB : the safe way is to install CouchDB by downloading the CouchBase Server ( http://www.couchbase.com/ ). You can also try from source ( http://couchdb.apache.org ), or via your package manager.\n\nMinimum required version : 1.0.1\n\n* Node.js : install node.js ( http://nodejs.org ) from source or with your package manager.\n\nMinimum required version : 0.6.0\n\nDon't forget to add the node binary's folder to the path of the Unix user which will run 10er10.\n\nDebian squeeze users, using the nodejs deb package : you should create a symlink from /usr/lib/nodejs to /usr/lib/node for connect to work.\n\n* NPM : install the Node package manager ( http://npmjs.org ). As of node.js 0.6.3, NPM is now included: no more need to install it !\n\n\nHint : **curl http://npmjs.org/install.sh | sh**\n\nPlease check that your npm version (using the command **npm -v**) is >= 1.0.0 .\n\nInstall audio utilities\n-----------------------\n\n10er10 website allows you to upload flac, mp3, m4a and ogg audio files. Flac, mp3 and m4a files will be converted on the fly to ogg.\n\n* install **lame** executable : it's certainly is available from your distribution packages\n\n* install **oggenc** executable : it's certainly is available from your distribution packages\n\n* install **ogginfo** executable : it's certainly available from your distribution packages\n\n* install **vorbiscomment** executable : it's certainly available from your distribution packages\n\n* install **flac** executable : it's certainly available from your distribution packages\n\n* install **faad** executable : it's certainly available from your distribution packages\n\nInstall graphics utilities\n---------------------------\n\n10er10 website allows you to upload images related to songs (eg. album artwork).\n\n* install **GraphicsMagick** executables : it's certainly available from your distribution packages\n\nAbout 10er10 running environments\n---------------------------------\n\n10er10 got two distinct environments : dev and prod. The main difference is that, in the prod environment, all static files are cached by the node.js server (so they are read only once from the filesystem).\n\n10er10 dev HTTP port is 8888. 10er10 prod HTTP port is 8124.\n\nInstall 10er10 files & required node modules\n--------------------------------------------\n\nUnzip/tar your 10er10 download.\n\ncd to the 10er10 root directory (the one that contains the *audio*, *node* and *views* folders).\n\n* node modules : install required node packages :\n\n        npm install\n\nYou should now have a new **node_modules** folder at the same level as the \"audio\", \"node\" and \"views\" folders.\n\nConfigure 10er10\n----------------\n\nBeginning from 0.6, the preferred way to tweak the configuration is to create a new file **node/config.local.js** and put the settings you want to overwrite.\n\nExample : if you need to set the path where audio file are stored to */some/where/on/the/disk*, open **node/config.local.js** and define the variable inside: like :\n\n    exports.audio = { dir: \"/some/where/on/the/disk\" };\n\nDoing this, your configuration will be kept when you upgrade your 10er10 server.\n\nOpen **node/config.js**\n\n* setup your databases configuration\n\n10er10 uses 4 couchdb databases. Look at **exports.couch_prod** and **exports.couch_dev** objects, and be sure to point the DSN to your CouchDB server. Databases will be created by the installer.\n\n* configure audio path\n\n10er10 needs two distinct folders to store audio files: \n\n\n- exports.audio.tmpdir : the temporary folder is where the uploaded files are stored\n- exports.audio.dir : this is where the ogg files are stored. \n\nOf course, those two folders should be writable by the unix user that will launch the node server.\n\n* configure images path\n\n10er10 needs two distinct folders to store images:\n\n- exports.images.tmpdir : the temporary folder is where the uploaded files are stored (could be the same than exports.audio.tmpdir)\n- exports.images.dir : this is where the images are stored. \n\n\n* about audio URI\n\n**exports.audio_root** is used by the browser to know where is the path to the audio files. If your 10er10 root is \"/\", then the audio_root is \"/audio\". If your 10er10 root is \"/somewhere/10er10\", set audio_root to \"/somewhere/10er10/audio\". You can also set the complete URL ( eg http://my.domain.com/10er10/audio ). Unless you're behind a reverse proxy and you know what you're doing, don't change this setting.\n\n\n* configure Unix utilities\n\nLook at exports.cmds.\n\n- exports.cmds.lame : the path to the lame executable\n- exports.cmds.oggenc : the path to the oggenc executable\n- exports.cmds.ogginfo : the path to the ogginfo executable\n- exports.cmds.vorbiscomment : the path to the vorbiscomment executable\n- exports.cmds.flac : the path to the flac executable\n- exports.cmds.faad : the path to the faad executable\n\nStill here ? Let's go for the fun part.\n \nLaunch the installer\n--------------------\n\ngo into the node/install directory and run the installer.js script.\n\nTo setup dev databases:\n\n    cd node/install\n    node install.js\n\nTo setup prod databases:\n\n    cd node/install\n    node install.js -p\n\n\nCreate a 10er10 user\n--------------------\n\nGo into the node/admin directory and run the d10-createUser.js script.\n\nThe password should be hard enough, or the account won't be created. (at least 8 characters, at least 4 distinct characters).\n\nWon't work :\n\n    test\n    xxxxxxxx\n\n\n\nTo create a user on dev install :\n\n    cd node/admin\n    node d10-createUser.js login thepassword\n\nTo create a user on prod install :\n\n    cd node/admin\n    node d10-createUser.js login thepassword -p\n\nLaunch the server\n-----------------\n\nGo into the node directory and run the server.js script :\n\nTo launch the dev instance :\n\n    cd node\n    node server.js\n\nTo launch the prod instance :\n\n    cd node\n    node server.js -p\n\n\nYou can fire you browser and go to http://[your server]:8888/ if you launched the dev instance, http://[your server]:8124/ if you launched the prod server.\n\nBonus: Configure your invites server\n------------------------------------\n\nYou want to send some friends an email so they can create an account on your 10er10 server and start using the application ? The doc folder contains a file to help you configure invites server.\n\n\nWhat else ?\n-----------\n\nFork, patch, send pull requests !\n\nFollow 10er10 development : https://plus.google.com/u/0/b/109983204693472020055/\n","maintainers":[{"name":"michael_bailly","email":"mickael.bailly@free.fr"}],"time":{"modified":"2022-06-12T14:05:30.154Z","created":"2013-10-15T20:08:22.680Z","0.23.0":"2013-10-15T20:11:28.552Z"},"author":{"name":"Michael Bailly","email":"mickael.bailly@free.fr"},"repository":{"type":"git","url":"https://github.com/dready92/10er10"}}