X-Git-Url: https://vcs.fsf.org/?a=blobdiff_plain;f=README.md;h=c780c2ab940aedc2bef6c643070ad427bf4be4f1;hb=00d1b8cabba46e599eceadf1766fc42fbcaeda58;hp=42a2f7a47df5b914584dcd952b065a3a1926b30c;hpb=66fa38427929a6a2f5b6fe717164a1cf1d63769c;p=KiwiIRC.git diff --git a/README.md b/README.md index 42a2f7a..c780c2a 100755 --- a/README.md +++ b/README.md @@ -1,33 +1,51 @@ -# Installation +### Kiwi IRC - A hand-crafted IRC client +Kiwi IRC is a fully featured IRC client that can be extended to suit almost any needs. +Using the web application is extremly simple even without any IRC knowledge as all the common needs are built directly into the UI. -* Install the dependencies +For more information see https://kiwiirc.com or live instance of the application can be found at https://kiwiirc.com/client/. +Our development IRC channel is on the Freenode network, irc.freenode.net #kiwiirc. - $npm install jade +[![Visit our IRC channel](https://kiwiirc.com/buttons/irc.freenode.net/kiwiirc.png)](https://kiwiirc.com/client/irc.freenode.net/#kiwiirc) - $npm install node-static - $npm install uglify-js +### Installation - $npm install socket.io +*Note: This requires Node.js to run. Make sure you have installed Node.js first! http://nodejs.org/download/* - $npm install socket.io-client - -* Edit the configuration file +1. Download the Kiwi source or clone the git repository: - $nano node/config.json - -* If you're using SSL, create your certificate and key, place it in the node foder. + `$ git clone https://github.com/prawnsalad/KiwiIRC.git && cd KiwiIRC` -# Running - $node node/kiwi.js +2. Install the dependencies: -# Bugs -Report bugs using the issue tracker on github: https://github.com/prawnsalad/KiwiIRC/issues + `$ npm install` + +3. Copy and edit the configuration file as needed: + + `$ cp config.example.js config.js` + + `$ nano config.js` + +4. Make sure the client code is built: + + `$ ./kiwi build` -# Licence -To be decided +### Running +From the source folder: `$ ./kiwi start` + +You can also run kiwi in the foreground to see any output by using the `-f` flag. Eg: `$ ./kiwi -f` + +Open your new Kiwi instance in your browser. By default: http://localhost:7778/ + + +### Bugs +Report bugs using the issue tracker on github: https://github.com/prawnsalad/KiwiIRC/issues + +### Licence +GNU Affero +http://www.gnu.org/licenses/agpl.html -# Thanks to -The KiwiIRC logo credited to Michael Drahony (www.drahony.com) \ No newline at end of file +### Thanks to +The KiwiIRC logo credited to Michael Drahony (www.drahony.com)