Journal Fabulous Club

jfc is an utility to make reviewing ArXiv papers for your Journal Club easier.



Consider using pipx.

pipx install git+

Otherwise, if you are using pip:

pip install git+

How to Use

jfc aggregates unseen articles from the specified timeframe (see the configuration section), and displays them to you in an interactive prompt. From the title, you can choose to read the abstract, and from there you can choose to open the ArXiv PDF.

Run jfc to get an interactive prompt.


jfc has some configuration parameters, which are set in the TOML file that lives in the configuration directory (as reported by appdirs).

Running jfc config will output the full path of the configuration file. Since most editors accept a path as an argument for the file to open, this means you can quickly edit the configuration (in bash) with

<div class="highlight highlight-source-shell position-relative overflow-auto" data-snippet-clipboard-copy-content=" $(jfc config)

<your favourite editor> $(jfc config)