:app twitter

Be superficial in plain text

1. Description

Enjoy twitter from emacs.

  • View various timelines side by side, e.g. user’s timeline, home, etc.
  • Post new tweets
  • Send direct messages
  • Retweet
  • Follow and un-follow users
  • Favorite tweets

1.1. Maintainers

This module has no dedicated maintainers. Become a maintainer?

1.2. Module flags

This module has no flags.

1.4. Hacks

No hacks documented for this module.

2. Prerequisites

  • For SSL connection (required by Twitter’s API), one of the followings is required:
  • GnuPG is required for keeping the OAuth token encrypted in local storage.
  • twittering-icon-mode converts retrieved icons into XPM by default. To achieve this and for displaying icons in formats that are not supported by Emacs as well as for resizing icon images, ImageMagick is required.

    To build emacs with ImageMagick support the --with-imagemagick flag needs to be passed to the configure script, e.g. ./configure --with-imagemagick. For detailed instruction on how to build Emacs from source please refer to INSTALL in Emacs’ savannah repository.

  • For keeping retrieved icons in local storage, gzip is required.

3. TODO Usage

This module’s usage documentation is incomplete. Complete it?

3.1. Commands & Keybindings

Here is a list of available commands and their default keybindings (defined in config.el).

command keybind description
+twitter/quit q Close current window
+twitter/quit-all Q Close all twitter windows and buffers, and delete workspace

And when :editor evil +everywhere is active:

command keybind description
twittering-favorite f Favorite/Like a tweet
twittering-unfavorite F Un-favorite/Un-like a tweet
twittering-follow C-f Follow user
twittering-unfollow C-F Un-follow user
twittering-delete-status d Delete a tweet
twittering-retweet r Retweet
twittering-toggle-or-retrieve-replied-statuses R Toggle or retrieve replies
twittering-update-status-interactive o Update tweets
+twitter/ace-link O Open some visible link from a twittering-mode buffer using ace
twittering-search / Search
twittering-goto-next-status J Go to next tweet
twittering-goto-previous-status K Go to previous tweet
twittering-goto-first-status gg Go to first tweet
twittering-goto-last-status G Go to last tweet
twittering-goto-next-status-of-user gj Go to next tweet of user
twittering-goto-previous-status-of-user))) gk Go to previous tweet of user

4. TODO Configuration

This module has no configuration documentation yet. Write some?

5. Troubleshooting

  • Evil users: Currently twittering-mode binds SPC, breaking its functionality as a leader key. To work around this issue you may use M-SPC instead when in twittering-mode.

6. TODO Appendix

This module has no appendix yet. Write one?