||5 years ago|
|dist||5 years ago|
|lib||5 years ago|
|locale||5 years ago|
|sql/SQLite3||5 years ago|
|tests||5 years ago|
|.gitattributes||6 years ago|
|.gitignore||5 years ago|
|.php_cs.dist||5 years ago|
|CONTRIBUTING.md||5 years ago|
|LICENSE||5 years ago|
|README.md||5 years ago|
|arsse.php||5 years ago|
|bootstrap.php||5 years ago|
|build.xml||5 years ago|
|composer.json||5 years ago|
|composer.lock||5 years ago|
|phpdoc.dist.xml||5 years ago|
The Advanced RSS Environment
The Arsse is a news aggregator server which implements version 1.2 of NextCloud News' client-server synchronization protocol. Unlike most other aggregator servers, The Arsse does not include a Web front-end (though one is planned as a separate project), and it relies on existing protocols to maximize compatibility with existing clients.
At present the software should be considered in an "alpha" state: though its core subsystems are covered by unit tests and should be free of major bugs, not everything has been rigorously tested. Additionally, though the NextCloud News protocol is fully supported, many features one would expect from other similar software have yet to be implemented. Areas of future work include:
- Support for more database engines (PostgreSQL, MySQL, MariaDB)
- Providing more sync protocols (Tiny Tiny RSS, Fever, others)
- Complete tools for managing users
- Better packaging and configuration samples
The Arsse has the following requirements:
- A Linux server utilizing systemd and Nginx (tested on Ubuntu 16.04)
- PHP 7.0.7 or newer with the following extensions:
- Privileges to create and run daemon processes on the server
At present, installation of The Arsse is rather manual. We hope to improve this in the future, but for now the steps below should help get you started. The instructions and configuration samples assume you will be using Ubuntu 16.04 (or equivalent Debian) and Nginx; we hope to expand official support for different configurations in the future as well.
- Extract the tar archive to
- If desired, create
config.defaults.phpas a guide. The file you create only needs to contain non-default settings. The
userPreAuthsetting may be of particular interest
- In a terminal, execute the following to start the feed fetching service:
sudo systemctl enable arsse sudo systemctl start arsse
Configuring the Web server and PHP
Sample configuration parameters for Nginx can be found in
arsse/dist/nginx-fcgi.conf; the samples assume a server group has already been defined for PHP. How to configure an Nginx service to use PHP and install the required PHP extensions is beyond the scope of this document, however.
The Arsse currently includes a
user add <username> [<password>] console command to add users to the database; other user management tasks require manual database edits. Alternatively, if the Web server is configured to handle authentication, you may set the configuration option
true and The Arsse will defer to the server and automatically add any missing users as it encounters them.
Installation from source
If installing from the Git repository rather than a download package, you will need to follow extra steps before the instructions in the section above.
First, you must install Composer to fetch required PHP libraries. Once Composer is installed, dependencies may be downloaded with the following command:
php composer.phar install -o --no-dev
Second, you may wish to create an example configuration file using the following command:
php ./arsse.php conf save-defaults "./config.defaults.php"
The Arsse is made available under the permissive MIT license. See the
LICENSE file included with the distribution or source code for exact legal text. Dependencies included in the distribution may be governed by other licenses.
Please refer to
CONTRIBUTING.md for guidelines on contributing code to The Arsse.
To run the test suite, you must have Composer installed as well as the command-line PHP interpreter (this is normally required to use Composer). Port 8000 must also be available for use by the built-in PHP Web server.
# first install dependencies php composer.phar install # run the tests ./tests/test
The example uses Unix syntax, but the test suite also runs in Windows. By default all tests are run; you can pass the same arguments to the test runner as you would to PHPUnit:
./tests/test --testsuite "Configuration"