X-Git-Url: https://vcs.fsf.org/?a=blobdiff_plain;f=README.md;h=7868c356695a02ba7d0c3c1a58c1861e0009cc47;hb=d0469a6fb843c79fca0b10d3fc0e27f3b3ccaca8;hp=9026079088d89272e4d03c22e3396c2142ade190;hpb=ed515498b06ad5ba2a86c159052100b504a8d5ba;p=KiwiIRC.git diff --git a/README.md b/README.md index 9026079..7868c35 100755 --- a/README.md +++ b/README.md @@ -1,31 +1,49 @@ -# Installation -* Get the Kiwi source and dependencies +### 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. - $git clone https://github.com/prawnsalad/KiwiIRC.git - $npm install - -* Create your SSL certificate and key, place it in the server folder. +For more information see https://kiwiirc.com or an example of the application can be found at https://kiwiirc.com/client/. +Our development IRC channel is on the Freenode network, irc.freenode.net #kiwiirc -* Edit the configuration file - $nano server/config.json - -# Running -Either use npm +### Installation - $npm start +*Note: This requires Node.js to run. Make sure you have installed Node.js first! http://nodejs.org/download/* -or run node directly +1. Download the Kiwi source or clone the git repository: - $node server/kiwi.js + `$ git clone git@github.com:prawnsalad/KiwiIRC.git && cd KiwiIRC` -# Bugs +2. Install the dependencies: + + `$ 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` + + +### 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 +### Licence GNU Affero http://www.gnu.org/licenses/agpl.html -# Thanks to +### Thanks to The KiwiIRC logo credited to Michael Drahony (www.drahony.com)