Skip to main content

reverse-engineered library and basic client for using Google's Hangouts chat protocol

Project description

hangups is a Python library for writing instant messaging clients that interoperate with Google Hangouts. hangups also includes a reference client with a command line user interface.

In May 2013, Google replaced their “Talk” instant messaging product, based on XMPP, with “Hangouts”, which adopted a proprietary, non-interoperable protocol. Because of this, hangouts must be implemented by reverse-engineering. For now it’s still possible to connect to Hangouts using the standard XMPP protocol, but this restricts features like group messaging that hangups allows.

hangups is working, but is pre-alpha quality. The API will change, and it shouldn’t be relied on for serious work.

Screenshot

What works

  • logging in (with second factor support)

  • switching between conversations

  • receiving chat messages and other events via push

  • sending chat messages

Running

Python 3.4 is required (Python 3.3 might work but is not tested). To install and run (virtualenv recommended):

pip install hangups
hangups

Follow the prompts to log into your Google account. In the Conversations tab, use arrow keys to scroll through the list of existing conversations, and press return to select one. In a conversation, use arrow keys to scroll through messages and to select the “Send message” box. Type a message and press return to send it. At any time you use use ctrl+d and ctrl+u to switch between tabs.

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.1.tar.gz (18.3 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