81 lines
2.9 KiB
ReStructuredText
81 lines
2.9 KiB
ReStructuredText
|build-status| |melpa-dev|
|
|
|
|
Twitter: millions of users can't be wrong... or not.
|
|
|
|
.. COMMENTARY (see Makefile)
|
|
|
|
.. |build-status|
|
|
image:: https://github.com/dickmao/nntwitter/workflows/CI/badge.svg?branch=dev
|
|
:target: https://github.com/dickmao/nntwitter/actions
|
|
:alt: Build Status
|
|
.. |melpa-dev|
|
|
image:: https://melpa.org/packages/nntwitter-badge.svg
|
|
:target: http://melpa.org/#/nntwitter
|
|
:alt: MELPA current version
|
|
.. |melpa-stable|
|
|
image:: http://melpa-stable.milkbox.net/packages/ein-badge.svg
|
|
:target: http://melpa-stable.milkbox.net/#/ein
|
|
:alt: MELPA stable version
|
|
|
|
.. image:: https://github.com/dickmao/gnus-imap-walkthrough/blob/master/thumbnail.png
|
|
:target: https://youtu.be/DMpZtC98F_M
|
|
:alt: Replacing Thunderbird With Gnus
|
|
|
|
.. image:: screenshot.gif
|
|
.. |--| unicode:: U+2013 .. en dash
|
|
.. |---| unicode:: U+2014 .. em dash, trimming surrounding whitespace
|
|
:trim:
|
|
|
|
Install
|
|
=======
|
|
We are trying to push ELPASO_ as the preferred package installer.
|
|
Alternatively, directly clone this repo and ``make install``.
|
|
|
|
**On 27 April 2023, Twitter actualized its promised embargo of Free
|
|
Tier applications including nntwitter.** While the announcement to
|
|
move Twitter's API to a paid model occurred much earlier in February
|
|
2023, we only witnessed HTTP 403 (Forbidden) responses shortly after
|
|
midnight today.
|
|
|
|
We want to thank the user of nntwitter for supporting us through the years.
|
|
Yes, "user" is singular. We also want to thank Mr. Musk for exercising
|
|
fiscal discretion in terminating free access to its API. While we ourselves
|
|
balk at ponying 100$ per month required of Basic Access, our frugality
|
|
is not Mr. Musk's fault. We hold out hope a sponsor will materialize to
|
|
restore nntwitter to its erstwhile glory.
|
|
|
|
Usage
|
|
=====
|
|
In your ``.emacs`` or ``init.el``, use ONE of the following:
|
|
|
|
::
|
|
|
|
;; Applies to first-time Gnus users
|
|
(custom-set-variables '(gnus-select-method (quote (nntwitter ""))))
|
|
|
|
or, if you're an existing Gnus user,
|
|
|
|
::
|
|
|
|
;; Applies to existing Gnus users
|
|
(add-to-list 'gnus-secondary-select-methods '(nntwitter ""))
|
|
|
|
Then ``M-x gnus``.
|
|
|
|
Initial setup should guide you through OAuth and find your existing feeds.
|
|
|
|
Select a feed via ``RET``. Rapidly catch yourself up via ``N`` and ``P``. Instantly catch-up with ``c``.
|
|
|
|
From the ``*Group*`` buffer, press ``g`` to refresh all feeds. ``M-g`` on a particular feed to refresh individually.
|
|
|
|
From the summary buffer, ``/o`` redisplays articles already read. ``x`` undisplays them.
|
|
|
|
Gnus beginners may find the interface bewildering. In particular, feeds with no unread articles do not display. Use ``L`` to bring them out of hiding.
|
|
|
|
.. _walkthrough: https://github.com/dickmao/gnus-imap-walkthrough
|
|
.. _Cask: https://cask.readthedocs.io/en/latest/guide/installation.html
|
|
.. _Getting started: http://melpa.org/#/getting-started
|
|
.. _virtualenv: https://virtualenv.pypa.io/en/stable
|
|
.. _PRAW: https://github.com/praw-dev/praw/pull/1094
|
|
.. _ELPASO: http://github.com/dickmao/elpaso
|