trollegle client
1.0.0
This is an extensible trollegle client written in JavaScript. Another (SimpeClient.java) is included in the trollegle repository.
To run this, you must have node.js installed. In your clone or copy of the repository you must call npm install. Then call npm start or node index to start the client.
After the client is running, call /-navigate for help with the UI and call /-help full for a list of commands, and a general description.
Now there is a graphical user interface, as an electron app. To use the gui, call npm run gui. To bundle the gui into an executable, call npm run bundle. To use the command-line interface instead, call npm run cli.
This client doesn't support tor circuits at the moment, but besides that it supports all of the features of SimpleClient.java. It also supports features that aren't included in SimpleClient:
actual file logging with /-out instead of having to rely on standard output redirection in the execution line.
view the current pulses with /-pulses
/-proxymove
control over display: display output in terminal or not, and display traditional (without Stranger: , and You: replaced by >) versus verbose
/-loadrc path run commands from the file
/-room room challenge password, /-enablelogin useful with /-loadrc for login with /-challenge
a pleasant UI that supports scrolling, colors messages according to their type, and doesn't include interferrence between the display of the input and output. Type /-navigate for help with the UI.
a few other minor features
The main benefit of this client comes from it's file organization and extensibility. A partial documentation and explaination of trollegle-client is available.
To add new commands, simply
extend ClientBehavior.js, override addAll() and call super.addAll().
Then, extend Client.js, override makeBehavior(), and include the if (require.main === module) check in your file.
To modify the behavior of the client (e.g. in order to make a bot with automatic behavior, perhaps to let users play hangman), simply extend Client.js, add event listeners, and include the if (require.main === module) check.
A hangman bot example is now available!
To run it, navigate to its subdirectory, call npm install, and then call npm start. You might wish to manually set a lurkrate with /-lurkrate 5.
captcha: <...>?This means that you need to solve a captcha for your ip in the browser before you can connect. However, if it turns out that you are captcha banned (a new captcha on every connection), you need to takeover a connection if you want to use the client. To do this, on startup (by a command-line argument) call -takeover=<id>, where <id> is replaced by the id that starts with central2:. If you have a connection open in the browser, you probably can inspect the network requests by opening developer tools. From there, search for a request to /events and locate its form data.
You also might be able to use a proxy to get around a captcha. You can set a SOCKS proxy with /-proxy <host>:<port>. If you'd prefer to use the direct connection after establishing the chat (faster, less chance of dying), call /-proxymove on.
By default, different types of messages are assigned different colors. It's possible that your terminal re-maps some of the base 16 colors by default. Your terminal might have options to change this color mapping, though. Also, the command /-color off will turn off message colors if you are recieving bad results.
Are you using Windows PowerShell? By default, Windows PowerShell re-maps magenta and dark yellow, and sets a different background color. You can change your PowerShell properties if you wish so that these colors are mapped correctly.
If you're on Windows 10, the issue is probably that you've selected some text, putting the process into selection mode. When a program tries to output text in selection mode, its process is paused. You can tell that a process is in selection mode because the title in the banner is prepended with "Select ". This is an issue with the Windows 10 console, not trollegle-client. You can allow the process to resume by pressing escape. You can also disable selection mode if you wish.
You need to call npm install in the directory and have git installed.
