paul-issartel / nnreddit

Reddit backend for Gnus
GNU General Public License v3.0
0 stars 0 forks source link

nnreddit

A Reddit backend for the Gnus newsreader.

NOTE: this backend only supports reading, login and posting are not implemented. Message status (read vs. unread, new, flagged) is also not supported.

A newer and more complete backend can be found here: https://github.com/dickmao/nnreddit

Usage

Add these lines to your .emacs or .gnus file:

(require 'nnreddit "/path/to/nnreddit.el")
(add-to-list 'gnus-secondary-select-methods
             '(nnreddit ""))

Then subscribe to a group from within Gnus, either by pressing 'U' in the Group buffer and entering "nnreddit:some-subreddit", or with the following command:

(gnus-group-unsubscribe-group "nnreddit:some-subreddit")

IMPORTANT: you need to add a (display 'all) parameter to every nnreddit group (use 'G c' or 'G p' from the group buffer to set this parameter), since there is currently no proper tracking of the read/unread status of each message. Without this parameter some articles or comments may not be displayed.

Until the read/unread status is implemented, you may also want to set the gnus-summary-goto-unread variable to 'never in nnreddit buffers to ease navigation.


You can also browse individual threads (or sub-threads) with the following syntax:

;; Single thread
(gnus-group-unsubscribe-group "nnreddit:some-subreddit/comments/link-id")
;; Sub-thread
(gnus-group-unsubscribe-group "nnreddit:some-subreddit/comments/link-id/comments/comment-id")

In other words, simply take the URL of any Reddit thread, replace "https://www.reddit.com/r/" with "nnreddit:" and subscribe to that in Gnus.

Alternatively, you can subscribe to a thread or sub-thread directly from the summary buffer with the `nnreddit-subscribe-to-thread' command.

(make sure to set the (display 'all) parameter for such groups as well)

Screenshots

Screenshot of a Reddit link article in Gnus

Screenshot of a Reddit comment in Gnus