<commit_before># Wowser

World of Warcraft in the browser using JavaScript and WebGL.

Licensed under the **MIT** license, see LICENSE for more information.


## Features

 * Lightweight in-browser client without reliance on external plugins.
 * Aims to be expansion agnostic, currently supporting Wrath of the Lich King.
 * A low-level interface for developing bots/tools and debugging servers.


## Usage & API

Wowser is both a client as well as a low-level API, allowing one to interact with a World of Warcraft server, behaving exactly as an official client would.

The project is very much a work in progress, but is already capable of successfully authenticating, logging into a realm and listing chat messages.


## Demo

To utilize raw TCP connections a WebSocket proxy is required for JavaScript clients. The steps below will outline on how to get a demo up and running.

1. Make sure you have [Python](http://python.org/) and [pip](http://www.pip-installer.org/) installed on your system.

2. Install [WebSockify](https://github.com/kanaka/websockify/) as follows:

  ```shell
  sudo pip install websockify
  ```

3. WebSockify can - among other things - act as a proxy for raw TCP sockets.

   For now, you will want to proxy both port 3724 (auth) and 8129 (world). If your server is on the same machine as your client, use a different set of ports.

   ```shell
   websockify 3724 host:3724
   websockify 8129 host:8129
   ```

4. Clone this project:

   ```shell
   git clone git://github.com/timkurvers/wowser.git
   ```

5. Configure `index.html` with the correct host, username and password.

6. Open `index.html` in your favourite modern browser (Chrome 20+, Firefox 15+, Safari 5+) and see the console for activity.


## Development & Contribution

Wowser is written in [CoffeeScript](http://coffeescript.org/) and developed with [Grunt](http://gruntjs.com/).

Getting this toolchain up and running, is easy and straight-forward:

1. Get the code:

   ```shell
   git clone git://github.com/timkurvers/wowser.git
   ```

2. Download and install [NodeJS](http://nodejs.org/#download) (includes NPM) for your platform.<commit_msg>Demo can now be found on GitHub pages<commit_after># Wowser

World of Warcraft in the browser using JavaScript and WebGL.

Licensed under the **MIT** license, see LICENSE for more information.


## Features

 * Lightweight in-browser client without reliance on external plugins.
 * Aims to be expansion agnostic, currently supporting Wrath of the Lich King.
 * A low-level interface for developing bots/tools and debugging servers.


## Usage & API

Wowser is both a client as well as a low-level API, allowing one to interact with a World of Warcraft server, behaving exactly as an official client would.

The project is very much a work in progress, but is already capable of successfully authenticating, logging into a realm and listing chat messages.


## Demo

To utilize raw TCP connections a WebSocket proxy is required for JavaScript clients. The steps below will outline on how to get a demo up and running.

1. Make sure you have [Python](http://python.org/) and [pip](http://www.pip-installer.org/) installed on your system.

2. Install [WebSockify](https://github.com/kanaka/websockify/) as follows:

  ```shell
  sudo pip install websockify
  ```

3. WebSockify can - among other things - act as a proxy for raw TCP sockets.

   For now, you will want to proxy both port 3724 (auth) and 8129 (world). If your server is on the same machine as your client, use a different set of ports.

   ```shell
   websockify 3724 host:3724
   websockify 8129 host:8129
   ```

4. Visit http://timkurvers.github.io/wowser in your favourite modern browser.

5. For more insight into what's going on, open the developer tools and view the console.


## Development & Contribution

Wowser is written in [CoffeeScript](http://coffeescript.org/) and developed with [Grunt](http://gruntjs.com/).

Getting this toolchain up and running, is easy and straight-forward:

1. Get the code:

   ```shell
   git clone git://github.com/timkurvers/wowser.git
   ```

2. Download and install [NodeJS](http://nodejs.org/#download) (includes NPM) for your platform.
{'fraction_non_alphanumeric': 0.08325381679389313, 'fraction_numerical': 0.016221374045801526, 'mean_word_length': 3.8418013856812934, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 2, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 6, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5463093', 'n_tokens_mistral': 1251, 'n_tokens_neox': 1154, 'n_words': 562}