hangups

Start hangups

$ hangups

$ hangups --token-path [path/to/token]

$ hangups -h

hangups [OPTIONS] {auth|clients|conversations|debug|...} [ARGS]

--cookies PATH
    Path to cookies file for persistent authentication

--refresh TOKEN
    OAuth2 refresh token to skip interactive login

--user USERNAME
    Google username/email for authentication

--password PASSWORD
    Google password (insecure; use with caution)

--help
    Show help message and exit

--version
    Display hangups version

hangups is an open-source command-line interface (CLI) for Google's Hangouts messaging service, implemented as a Python library and executable. It enables users to interact with Hangouts directly from the terminal, supporting features like listing conversations, sending text messages, uploading images, viewing history, managing presence, and handling OTR encryption for private chats.

Key capabilities include OAuth2 authentication, conversation management, user mentions, photo uploads, and presence status updates (available, idle, etc.). It fetches conversation data via Google's APIs, storing cookies and tokens locally for subsequent sessions.

Originally designed for power users and scripters, it provides a lightweight alternative to graphical clients like the web app or desktop apps. However, Google discontinued Hangouts in November 2022, migrating users to Google Chat; thus, new accounts cannot authenticate, limiting it to legacy use.

Installation requires Python 3 and pip: pip install hangups. It depends on libraries like aiohttp and lxml for async operations and parsing.

Google Hangouts shut down in 2022; no new authentications possible. Uses deprecated APIs. Store credentials securely; avoid --password in scripts.

Auth: hangups auth
List convos: hangups conversations
Send msg: hangups send <conv_id> "Hello"

pip3 install --user hangups
Requires Python 3.6+ and Google account with Hangouts enabled.

Developed starting 2015 by Balló György as Python library. Gained popularity for CLI Hangouts access. Maintained on GitHub until service end; last release ~2021.

irssi(1), weechat(1), mcabber(1), profanity(1)