LinuxCommandLibrary
GitHubF-DroidGoogle Play Store

hangups

terminal-based Google Hangouts client (defunct: Hangouts was shut down in 2022)

TLDR

Start hangups (prompts an OAuth login on first run, then caches the refresh token)
$ hangups
copy
Use the manual (copy-paste) OAuth login flow
$ hangups --manual-login
copy
Use a custom configuration file
$ hangups --config [hangups.conf]
copy
Enable verbose debug logging to a file
$ hangups --debug --log [hangups.log]
copy
Rebind a keyboard shortcut, e.g. quit
$ hangups --key-quit [ctrl q]
copy
Show the installed version
$ hangups --version
copy

SYNOPSIS

hangups [options]

DESCRIPTION

hangups was the first third-party instant messaging client for Google Hangouts, providing a Python library plus a terminal (urwid-based) reference client. It worked by reverse-engineering Google's proprietary Hangouts protocol, which let it support features like group messaging that weren't available to XMPP-based clients.

PARAMETERS

-c, --config FILE

Configuration file path.
-d, --debug
Log detailed debugging messages.
--manual-login
Use the manual (copy-paste) OAuth login flow instead of opening a browser.
--token-path PATH
Path used to store the cached OAuth refresh token.
--log FILE
Log file path.
-D, --discreet-notifications
Hide message details in desktop notifications.
--notification-type TYPE
Type of desktop notifications to create.
--key-quit, --key-next-tab, --key-prev-tab, --key-close-tab, --key-menu KEY
Rebind the corresponding action's key (defaults: ctrl e, ctrl d, ctrl u, ctrl w, ctrl n).
--col-scheme NAME
Colour scheme to use.
--keep-emoticons
Don't replace emoticons with corresponding emoji.
-v, --version
Print the installed hangups version.
-h, --help
Display help information.

CAVEATS

Google shut down consumer Hangouts in November 2022 and decommissioned the API hangups depended on; the client can no longer log in or connect, and the project has seen no functional release since (last PyPI release was 0.4.18, April 2022). It is kept online for reference only, not as a usable chat client.

HISTORY

hangups was created by Tom Dryer, with its first release in 2014, as an unofficial Google Hangouts client for terminal users. Several bots and bridges (HangupsBot, telepathy-hangups) were built on top of its protocol library before Hangouts itself was retired.

SEE ALSO

weechat(1), irssi(1), finch(1)

RESOURCES

Copied to clipboard
Kai