FichteFoll's Hexchat addons

This is just a compilation of modules and addons for hexchat, using its Python plugin.

Modules

pluginpref

Abstractions for hexchat's hexchat.*_pluginpref API, wrapped in a MutableMapping. All settings are prefixed with the plugin name internally to prevent collisions. Supports being wrapped with a JSON serializer, thus allowing to store lists and dictionaries too.

The interface is essentially a dict. For details, refer to docstring or tests (in same directory).

util

Collection of utility functions.

Refer to the source code and docstrings for details.

Addons

better_raw_modes.py

Transforms raw mode messages to remove redundant information.

Requires /set irc_raw_modes 1.

May cause incompatibilities with other scripts that rely on a certain Raw Modes format.

current_channel_replace.py

Expands a preceding # character to the current channel when you press space or tab after it. Hold shift key to insert literal space.

Note: Only works if at the end of input.

ff_twitch.py

Mutes spammy +o, -o as well as join and part messages if there are more than a certain number of users in a channel.

Automatically requests the twitch.tv/membership and twitch.tv/commands capabilities from the network.

smart_filter.py

Based on smartparts.py.

Mutes a variety of events for users that never talk, or haven't talked in a certain period (60 minutes by default).

• Muted events are: Joins, Parts, Renames and Mode Changes.
• If a recently joined user starts talking, his 'Join' event is late-emitted with the original timestamp.
• Handles renames.
• If a user that previously talked parts and joins again (or renames), the events are shown.
• Events for nicks in your notify list are always shown.

Works with ZNC bouncers and also works with *buffextras module using buffextras.py.

youtube_title.py

Print (or announce) a YouTube video's title.

Requires a Google API key! Set it using /ytt key set <key>.

By default, it will only print the title for you locally.

• /ytt get prints titles of the videos specified
• /ytt announce manages a list of channels where the title should be announced (i.e. /say)
• /ytt mute manages a list of channels where YouTube urls should be ignored
• /ytt key manages the stored key

How to obtain a Google API key

Prerequisites: A Google account

1. Create a project at https://console.developers.google.com/project
2. Browse "APIs & auth -> APIs" in the sidebar
3. Select "YouTube Data API"
4. Click "Enable API"
5. Browse "APIs & auth -> Credentials" in the sidebar
6. Click "Create new Key"
7. Select "Server Key" and leave the IP range input blank (or insert some IP range if you feel like it)