بدون توضیح

Michael Buesch 0b414ae448 db: Also reset updated_items, if setting all to seen		21 ساعت پیش
.github	97cf0a2f0c Add Github CI	2 هفته پیش
feeds	fe929850c9 page: Add NEW-marker to new items	21 ساعت پیش
feedscli	07944ea3c2 cli: Add command to set items to 'seen'	4 روز پیش
feedsd	39955d8501 Do not notify updated items by default	4 روز پیش
feedsdb	0b414ae448 db: Also reset updated_items, if setting all to seen	21 ساعت پیش
resources	03ba6d4ba8 Initial commit	2 هفته پیش
.gitignore	03ba6d4ba8 Initial commit	2 هفته پیش
COPYING	03ba6d4ba8 Initial commit	2 هفته پیش
Cargo.lock	ee36d7640d Update dependencies	22 ساعت پیش
Cargo.toml	2c29f3947b Add cli tool	1 هفته پیش
README.md	3ba326b7a4 Update Readme	1 هفته پیش
build.sh	03ba6d4ba8 Initial commit	2 هفته پیش
install.sh	2c29f3947b Add cli tool	1 هفته پیش

feedreader

Feedreader/rs is a Rust re-implementation of the original feedreader Python implementation.

The database format is almost fully compatible with the original. Re-using an existing database is possible. We don't implement 'enclosures', though. Existing enclosures in the database will be deleted.

Thanks

Thanks to Marco Lochen for the idea and for the original Python implementation.

Building and installing

Prerequisites

The Rust compiler must be installed to build feedreader. It is recommended to use the latest version of the stable Rust compiler. But Rust versions down to and including Rust 1.77 are supported by feedreader.

Rust installer

The Rust installer will install the compiler and the build tool cargo.

The build requires the additional cargo-audit and cargo-auditable tools to be installed. Run this command to install both tools:

cargo install cargo-audit cargo-auditable

The SQLite3 database has to be installed in your operating system.

If you use Debian Linux, you can use the following command to install SQLite3:

sudo apt install libsqlite3-dev

Building feedreader

Run the build.sh script to build feedreader.

After installing all build prerequisites, run the build script:

./build.sh

Installing feedreader

Then run the install.sh to install the feedreader to /opt/feedreader/:

./install.sh

-lsqlite3: No such file or directory

If during build you get the following error:

= note: /usr/bin/ld: cannot find -lsqlite3: No such file or directory
    collect2: error: ld returned 1 exit status

please install the SQLite 3 libraries and development files to your system.

On Debian Linux that is done with:

sudo apt install libsqlite3-dev

Configuring web server CGI

The web frontend feeds needs to be configured in your web browser as CGI application.

lighttpd web server

Add the following configuration to /etc/lighttpd/conf-enabled/feedreader.conf:

server.modules += ( "mod_cgi" )

$HTTP["url"] =~ "^/cgi-bin/" {
    cgi.assign = ( "" => "" )
    alias.url += ( "/cgi-bin/" => "/opt/feedreader/lib/cgi-bin/" )
}

Apache web server

Add the following configuration to /etc/apache2/conf-enabled/feedreader.conf:

ScriptAlias /cgi-bin/feeds /opt/feedreader/lib/cgi-bin/feeds

<Directory /opt/feedreader/lib/cgi-bin>
    AllowOverride None
    Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch -Indexes
    Require all granted
</Directory>

License / Copyright

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

README.md