Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


CI Status Documentation Status Snap Status

hangups is the first third-party instant messaging client for Google Hangouts. It includes both a Python library and a reference client with a text-based user interface.

Unlike its predecessor Google Talk, Hangouts uses a proprietary, non-interoperable protocol. hangups is implemented by reverse-engineering this protocol, which allows it to support features like group messaging that aren't available in clients that connect via XMPP.

hangups is still in an early stage of development. The reference client is usable for basic chatting, but the API is undocumented and subject to change. Bug reports and pull requests are welcome!

hangups screenshot


See the documentation for installation and usage instructions.

Projects using hangups

Related projects

  • Hangish: A Google Hangouts native client for Sailfish
  • Hangups-UWP: Hangups client for Universal Windows Platform
  • Parrot: The next generation messenger
  • WTalk: Client library and desktop client for Google Hangouts written in C#
  • YakYak: Desktop client for Google Hangouts
  • go-hangups: Port of hangups to Go
  • hangover: The first native Mac OS X client for Google Hangouts
  • hangups-rs: Port of hangups to Rust
  • hangupsjs: Port of hangups to Node.js
  • purple-hangouts: Hangouts plugin for libpurple
  • slangouts: A Hangouts/Slack bridge