A Gnus backend for Reddit.
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. |