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
• 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: missing documentation
• 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: Set a tldr for a chat using /bot tldr <message> (View using /bot tldr and clear using /bot tldr clear)
• 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] (https://github.com/hangoutsbot/hangoutsbot/wiki/Reference:-BaseBotRequestHandler-Class) 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] (https://github.com/hangoutsbot/hangoutsbot/wiki/Reference:-Permanent-Memory-(permamem)#unittest_convmem): helper plugin for [permanent conversation memory] (https://github.com/hangoutsbot/hangoutsbot/wiki/Reference:-Permanent-Memory-(permamem))
• [ ver < 2.7 ] [unittest_tags] (https://github.com/hangoutsbot/hangoutsbot/wiki/Reference:-User-and-Conversation-Tagging#basic-tag-manipulation) helper plugin for [users and conversations tagging] (https://github.com/hangoutsbot/hangoutsbot/wiki/Reference:-User-and-Conversation-Tagging)
• unittest_geticon: uses hangouts contact/getentitybyid API query to retrieve photo url of user
• 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!
• unittest_statusevents - demonstrates watermark and typing handlers, output latest read state (watermark) of users and their active typing status to console/stdout