Skip to main content

the first third-party instant messaging client for Google Hangouts

Project description

Build Status

hangups is the first third-party instant messaging client for Google Hangouts.

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. It’s usable for basic chatting, but users should keep another client handy. Bug reports, feature requests, and pull requests are welcome.

hangups screenshot

Trying it out

Python 3.3 or higher is required. To install the latest version of hangups, run:

pip install hangups

Or check out the repository and run:

python setup.py install

Run hangups --help to see available options. Start hangups by running hangups.

The first time you start hangups, you will be prompted to log into your Google account. Your credentials will only be sent to Google, and only session cookies will be stored locally. If you have trouble logging in, try logging in through a browser first.

hangups uses a tabbed interface. The first tab is always the conversations list tab, which lets you use the up/down arrow keys to select an existing conversation and open it in a new tab by pressing enter. Once you have multiple tabs open, you can use ctrl+u and ctrl+d and move up and down the list of tabs.

In a conversation tab, type a message and press enter to send it, or use the up/down arrows to scroll the list of previous messages.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hangups-0.1.3.tar.gz (26.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page