awesome-ryver

This package mostly started as a joke, and from the desire of adding some extra and funny formatting features to Ryver, without requiring administrator rights or any access to the server. This is done by either installing AwesomeRyver.user.js with Tampermonkey for the web version, or by script injection with this Python package for the desktop version.

In your browser

This is the simplest and quickest method:

• Install Tampermonkey in your browser
• Download AwesomeRyver.user.js
• Install it via Tampermonkey
• Go to ryver

On your desktop: with prebuilt binary

With near to zero install:

• Download the lastest AwesomeRyver-arch-version.zip release for your system
• Extract the archive
• Move both the AwesomeRyver binary and AwesomeRyver.user.js script next to your Ryver binary
• Run AwesomeRyver

On your desktop: with pip

If you have Python installed on your system, you may prefer to install this Python package with pip:

> pip install awesome-ryver

Make sure to download and move AwesomeRyver.user.js in the folder from where you will be running AwesomeRyver, then you can launch it with:

> awesome-ryver -e C:\Path\To\Ryver.exe

Or:

> python -m awesome_ryver -e C:\Path\To\Ryver.exe

Either way, you can show the help with:

> awesome-ryver -h
> python -m awesome_ryver -h

usage: awesome-ryver [-h] [-t TIMEOUT] [-e EXE] [-d] [-p PLUGIN]

Help

optional arguments:
  -h, --help            show this help message and exit
  -t TIMEOUT, --timeout TIMEOUT
                        Timeout when trying to launch Ryver
  -e EXE, --exe EXE     Path to Ryver executable
  -d, --devtools        Enable devtools access from Ryver
  -p PLUGIN, --plugin PLUGIN
                        Path to the plugin script

Commands

Those commands work when they are detected in received messages:

Command	Description	Preview
[color=FF0000]colored text[/color]	Generate a colored text with an hexadecimal color
[red]red text[/red]	Generate a colored text
[green]green text[/green]	Generate a colored text
[blue]blue text[/blue]	Generate a colored text
[rainbow]rainbow text[/rainbow]	Generate a rainbow text
[wave]wavy text[/wave]	Generate a wavy text
[html]<b>bold text</b>[/html]	Your message is replaced by the HTML code
[python/]	Print a magnificient Python in ASCII art

Those commands only work when clicking on the green Send button:

Command	Description	Preview
[version/]	Print AwesomeRyver version
[spoil]some secret[/spoil]	Hide the text until clicked
[rand10/]	Choose a random float between [0.0, 10.0[
[random10/]	Choose a random int between [0, 10[
[d10/]	Choose a random int between [1, 10]

More to come !

How to build the AwesomeRyver binary

First clone this repository:

> git clone https://github.com/Nauja/awesome-ryver.git
> cd awesome-ryver

Install pyinstaller:

> python -m pip install pyinstaller

Run pyinstaller:

> pyinstaller --onefile awesome_ryver/main.py

This generates a dist folder containing a main binary.

Simply rename the binary to AwesomeRyver and put it next to AwesomeRyver.user.js.

License

This content is released under the MIT License.