A Gnus backend for Reddit.
![Replacing Thunderbird With Gnus](https://github.com/dickmao/gnus-imap-walkthrough/raw/master/thumbnail.png?raw=true)
https://live.gitawonk.com/dickmao/nnreddit.git
Git paid, not played.
As of 06 July 2021, authentication behavior at Reddit changed such that nnreddit versions previous to 0.2.0 no longer work. Delete $HOME/.local/share/nnreddit/refresh-token
, and install the latest nnreddit.
As of 24 May 2020, to stay apace with the PRAW backend, nnreddit no longer supports python2. If your system keeps python 3.x in a separate alias such as python3
, you should M-x customize-variable RET nnreddit-python-command
to it.
We are trying to push ELPASO as the preferred package installer. Alternatively, directly clone this repo and make install
.
Also see Troubleshooting.
In your .emacs
or init.el
, use ONE of the following:
;; Applies to first-time Gnus users (custom-set-variables '(gnus-select-method (quote (nnreddit ""))))
or, if you're an existing Gnus user,
;; Applies to existing Gnus users (add-to-list 'gnus-secondary-select-methods '(nnreddit ""))
Then M-x gnus
.
Initial setup should guide you through OAuth and find your existing subreddit subscriptions.
Select a subreddit via RET
. Rapidly catch yourself up via N
and P
. Instantly catch-up with c
.
Create a post via a
.
Reply to articles with f
or r
. Include original with F
.
Vote articles via R -
(down), R =
(up), or R 0
(retract).
From the *Group*
buffer, press g
to refresh all subreddits. M-g
on a particular subreddit to refresh individually.
From the summary buffer, /o
redisplays articles already read. x
undisplays them.
S s
edits articles.
S c
cancels articles.
R g [subreddit]
takes you to an unsubscribed subreddit.
You can subscribe to it via the u
keybinding from the *Group*
buffer [1].
Gnus beginners may find the interface bewildering. In particular, subreddits with no unread articles do not display. Use L
to bring them out of hiding.
Clone this repo. Then install Cask. Then try make test-run-interactive
.
[1] | Gnus users are familiar with the tragedy of u doing double duty as subscriber and unsubscriber. u is really a toggle even though the attached command is gnus-group-unsubscribe-current-group —if that doesn't trigger your UX sensibility, then never mind I mentioned it. |