rowanmanning / audrey

A simple single-user and self-hosted feed reader
GNU General Public License v3.0
8 stars 3 forks source link

Audrey

Audrey is a simple single-user feed reader, focused on a no-frills reading experience. Audrey allows you to subscribe to RSS and Atom feeds and read content in one place.

Audrey is self-hosted; you can set up an installation on your own server or cloud provider. There's no creepy harvesting of your data, and no algorithms to recommend new content.

Latest build status

Note: Audrey is currently in beta

A screenshot of the Audrey home page, showing a single column list of feed entries to be read A screenshot of a blog post displayed within the Audrey interface

Table of Contents

Requirements

This application requires the following to run:

Running Locally

You can run Audrey locally if you intend on making your own changes, or just want to test it out. Follow these steps to get Audrey running on your local machine:

  1. Make sure you have all of the software listed in Requirements

  2. Clone this repository, and cd into it:

    ```sh
    git clone https://github.com/rowanmanning/audrey.git && cd audrey
    ```
  3. Install the application dependencies:

    ```sh
    npm install
    ```
  4. Copy the sample .env file to make changes to the configuration. You'll need to do this if you want sessions to persist between restarts of the application. The following command copies sample.env to .env:

    ```sh
    cp sample.env .env
    ```
  5. Build client-side assets (Sass):

    ```sh
    npm run build
    ```
    
    Or run the following if you want assets to automatically rebuild:
    
    ```sh
    npm run watch
    ```
  6. Start the application in production mode:

    ```sh
    npm start
    ```
    
    Or development mode if you want code changes to auto-restart the application:
    
    ```sh
    npm run start:dev
    ```
  7. Visit localhost:8080 in your browser (the port may be different if you made changes to the default .env file)

  8. Set up a password on the locally running site. You'll need to remember this password to regain access if your session expires

Running on a Server

The instructions for running on a server are the same as running locally apart from the following differences:

Cloud Provider Guides

Audrey has guides for the following common cloud providers:

Config Options

This application is configured using environment variables, or an .env file if you're running locally. The following options are available:

You can also change more configurations through the settings page of a running copy of Audrey, these additional configurations are stored in the database.

Beta Notice

Audrey is currently in beta, and may not have all of the features you expect from a feed reader yet. I'm deliberately keeping a reduced set of features, but please check the feature label in the issues before requesting anything

I really appreciate feedback on the stability of Audrey, if you're willing to give it a go as your primary feed reader then I'll be happy to address any bugs you come across during your day-to-day use.

Contributing

The contributing guide is available here. All contributors must follow this library's code of conduct.

License

Licensed under the GPLv3 license.
Copyright © 2020, Rowan Manning.