Skip to content

Latest commit

 

History

History
115 lines (86 loc) · 6.25 KB

README.md

File metadata and controls

115 lines (86 loc) · 6.25 KB

Ritsu x Emerald

A small addon to make EmeraldChat less bad.

Contents:

  1. How do I install RxE?
    1. Mobile Browsers
    2. Installing RxE
    3. What if I can't get RxE?
  2. What does it do?
    1. Upcoming features
    2. Screenshots
  3. Do you collect my data?

Installation

To install RxE, follow these steps:

  • (Android / Apple) Get a suitable browser (see Mobile Browsers).
  • Install a userscript manager as a browser extension (ViolentMonkey or TamperMonkey).
  • Install RxE into your browser by clicking here.
  • Refresh EmeraldChat, and change your settings in the new Ritsu Menu.

Mobile Browsers

To use RxE on mobile, choose one of the following options:

  • Android: Kiwi Browser (Google Play Store) - Chromium-based browser with Chrome extension support and extra features.
  • Android: Firefox Nightly (Google Play Store, YouTube Tutorial, Blog Post) - newest available version of Firefox for Android.
    Tutorial (click to reveal) On PC, create an add-on collection on addons.mozilla.org, and add your userscript manager to the collection. On Android, unlock Firefox Nightly's developer options by tapping the Firefox logo in the About Menu, and then input your User ID & collection from the collection URL as the "custom addon collection".
  • iOS: Alook Browser (App Store, one-time fee)
  • iOS: Gear Browser (App Store, subscription-based)
  • iOS: Tampermonkey for Safari (App Store, $1.99)
  • iOS: Tampermonkey for Safari — versions 6 to 11 (Extension File)

(Have a free working setup for iOS? Open an issue and you might see it here. See Stack Exchange discussion for more details on iOS support.)

Installing RxE

Once that's done, you can click here to install the latest RxE script. Alternatively, select a script in the repository to load a specific version (and then click on the Raw button). If your userscript manager doesn't prompt you to install the script, download it from the link and add it manually (for Tampermonkey, that's Utilities -> File -> Import). Warning: Never install scripts from untrusted sources.

What if I can't get RxE?

If you are on an unsupported device, or the installation process is too complicated for you, check if you can still fix crashed DMs with uBlock Origin:

  • Add the uBlock Origin extension to your browser.
  • Open its settings, and navigate to the My Filters tab.
  • Paste the following: https://emeraldchat.com/private_friends
  • Click Apply changes.

This will allow you to open DMs, but the DMs panel will no longer be available.

Features

  • Cosmetic: Themes, customizable layout, custom name colour, extra user info
  • Annoyances: Spam blocker, ad blocker
  • Unbreaking: Fixed layout, broken GC or DMs, muting chat sounds works
  • Karma: Tracking karma live

Upcoming features

  • Profile pictures (RxE-only)
  • Image sending, blurring & favouriting
  • Permanent muting
  • Blocking friend requests
  • Chat commands (.shrug, .rxelink, etc.)
  • Own picture gallery
  • **Bold** and *italics*
  • Highlighted name mentions
  • Clickable links
  • Working DM history
  • Material Icons¹ (using m:icon_name:) (RxE-only)

Screenshots

The following are some screenshots of the upcoming version of RxE

Main menu with RxE (Different themes)

Edit Profile with RxE

Your profile with RxE

Groupchat with RxE

User options with RxE

RxE's custom settings

(Want your screenshot featured here? Open an issue or get in touch with the team members.)

Privacy

Ritsu x Emerald doesn't collect or publish any data about you — it's just a simple addon.

For privacy-minded people:

  • RxE stores settings in your browser.

The following apply from version v0.11.0:

  • When including your profile picture in your bio, RxE sends data on your behalf to EmeraldChat to do so.
  • When uploading an image for use in chat or an Imgur profile picture, RxE sends your picture to Imgur (Privacy Policy).