Plugin List

(Note for Developers & Botmins: Plugin file/folder are matched to their actual names e.g. the default plugin can be found as plugins/default.py; and the image_linker_reddit plugin files can be found in the plugins/image_linker_reddit/ subfolder)

Standard Plugins

These are user-centric plugins.

• api: API to allow external services to run commands on the bot.
• autoreply: bot will automatically reply to some keyword it sees in chats
• botaliases: allows custom aliases for bot (e.g. /bot, !bot, !xyz, etc)
• botalive: advances the bot's last read status (watermark) every 15 minutes for global admins 1-to-1s, and groups every 3 hours - so that you know the bot is working
• cam_mail_intercept: Plugin that can be used for integrating surveillance systems, webcams and home automation systems into hangoutsbot. Not yet pulled in, source code contributed under https://github.com/infradom/hangoutsbot
• chance: users can roll a dice and flip coins
• chatlogger: log all chats to individual files, a modernised version of the obsolete chatlogger hooks
• cleverbot: implements (unofficially) Cleverbot replies to user messages
• [convtools] (https://github.com/hangoutsbot/hangoutsbot/wiki/Conversation-Tools-Plugin): add users and create conversations
  • [convtools_invitations] (https://github.com/hangoutsbot/hangoutsbot/wiki/Conversation-Invitations-Plugin): issue invites from one chat to another, and lets users claim them
• default: standard set of commands that can be used for bot administration and testing
• dnd: sets Do Not Disturb status, used by plugins: mentions, subscribe
• easteregg: delight (annoy) users with ponies and pitchforks!
• image_linker_reddit: detects keywords and displays meme-related images (based on [Reddit Image Linker Bot] (http://www.reddit.com/r/image_linker_bot/comments/2znbrg/image_suggestion_thread_20/))
• forwarding: forward messages from one conversation to another
• humor_hangoutcalls: detects video/voice calls and displays an amusing message after the call ends - also useful as working example for video/voice call handling
• image_links: detects user-posted image links and attaches the image (works with imgur links too!)
• image_memegenerator: searches and returns related meme from http://memegenerator.net/
• image_screenshot: take screenshots of urls (with the phantomjs headless web-browser)
• lookup: search a linked google spreadsheet and return the row
• lottery: administrators can create and run "lucky draws" for users
• mentions: receive an alert when somebody @mentions your name or nickname
• monitoradds: warn non-admin/mod users who add others into group hangouts
• namelock: lock the title of any group conversation and prevent users from changing it
• restrictedadd: only authorised users can add the bot into a conversation
• simplewikipedia: retrieve info from wikipedia with /bot wiki <term>
• simplytranslate: translate any sentence with Google Translate integration
• slack: Sync hangouts messages with slack messages (including Syncouts)
• starter: basic set of tools and functionality to get the bot running
• subscribe: receive alerts when specific keywords are said in a chat
• syncrooms: relay messages between different conversation groups
  • [syncrooms_config] (https://github.com/hangoutsbot/hangoutsbot/wiki/Syncouts-Plugin#managing-syncouts-via-bot-commands): attach/detach conversation to syncouts using bot commands
  • [syncrooms_autotranslate] (https://github.com/hangoutsbot/hangoutsbot/wiki/Syncouts-Plugin#automatic-translation-in-syncout-rooms): automatic translation of chats between conversation groups
• tldr: store message (a "TLDR") for later retrieval with /bot tldr <message>; view all stored TLDRs using /bot tldr; view single tldr with /bot tldr <number>; clear all using /bot tldr clear; clear single with /bot tldr clear <number>
• urbandict: get definitions from the creative users at http://www.urbandictionary.com with /bot urbandict <term>
• webbridge_hubot: An updated plugin that allows integration with HUBOT
• wolframalpha: Query WolframAlpha using /bot ask <term>. Be sure to grab an API key from the website

Example Plugins

These plugins are suitable references for beginning plugin developers.

Note: Plugin names that start with an underscore (_) are disabled on startup.

• _example_memory: demonstrates bot per-user and per-conversation memory
• _example_printrenames: outputs conversation rename events to console
• _example_watchmembers: outputs group membership changes i.e. users joining and leaving to console
• _example_webbridge: simple web-bridge that implements an incoming request listener with BaseBotRequestHandler and an outgoing message handler (outputs to console)

Unit-test Plugins

Unit-test plugins are used to test key framework features. They are also suitable for intermediate to advanced plugin developers.

Note: Plugin names that start with an underscore (_) are disabled on startup.

• [ver<2.7] unittest_convmem
  • helper plugin for permanent conversation memory
• [ver<2.7] unittest_tags
  • helper plugin for users and conversations tagging
• [ver<2.7] unittest_geticon; [ver>=2.7] _unittest_geticon
  • uses hangouts contact/getentitybyid API query to retrieve photo url of user
• [ver<2.7] unittest_reprocessor; [ver>=2.7] _unittest_reprocessor
  • test hidden message context and processing
• _unittest_memory
  • low-level test function for bot.memory
  • WARNING: enabling and using this plugin can result in memory corruption!
• _unittest_shutup
  • test sending handler priority and suppression
  • WARNING: enabling this blocks all bot messages!
• [ver<2.7] unittest_statusevents; [ver>=2.7] unittest_statusevents
  • demonstrates watermark and typing handlers, output latest read state (watermark) of users and their active typing status to console/stdout