selfoss: The multipurpose rss reader, live stream, mashup, aggregation web application
Clone or download
Latest commit 1bd6df9 Aug 14, 2018
Permalink
Failed to load latest commit information.
_docs website: remove iOs app link Aug 14, 2018
controllers feed: fix feed generator Jul 9, 2018
daos use proper types in API (#879) Apr 23, 2018
data Use Graby instead Full-Text-Rss Mar 18, 2017
docs use proper types in API (#879) Apr 23, 2018
helpers set error for sources with unknown spout Jan 9, 2018
public client: make sharers more flexible Apr 23, 2018
spouts spouts/reddit2: remove special imgur handling Apr 21, 2018
templates remove leftovers from before login was moved client-side Jun 6, 2018
utils ci: remove debug code Aug 14, 2018
.eslintrc.json lint js with ESlint Jun 27, 2017
.gitignore Clean up the .gitignore Dec 6, 2017
.htaccess migrate .htaccess syntax to aapche 2.4 (#722) Dec 28, 2016
.php_cs Sort use statements Dec 6, 2017
.travis.yml ci: Skip cleanup for Bintray deploys Aug 14, 2018
NEWS.md NEWS: update Aug 14, 2018
README.md post-release version bump Mar 5, 2018
cliupdate.php Use Graby instead Full-Text-Rss Mar 18, 2017
common.php post-release version bump Mar 5, 2018
composer.json spouts/reddit2: add .json extension to the correct part of URL Apr 21, 2018
composer.lock composer: update dependencies Aug 14, 2018
defaults.ini Add config option to hide the thumbnails Mar 9, 2018
gruntfile.js add machine-readable API description Mar 2, 2018
index.php use API for login/logout from the web client Jun 15, 2017
package.json post-release version bump Mar 5, 2018
phpstan.neon Fix some problems reported by PHPStan level 0 Apr 9, 2017
run.php Fix asset routing for PHP built-in server May 6, 2017

README.md

selfoss

Copyright (c) 2015 Tobias Zeising, tobias.zeising@aditu.de
https://selfoss.aditu.de
Licensed under the GPLv3 license
Version 2.19-SNAPSHOT

DOWNLOAD

INSTALLATION

  1. Upload all files of this folder (IMPORTANT: also upload the invisible .htaccess files)
  2. Make the directories data/cache, data/favicons, data/logs, data/thumbnails, data/sqlite and public/ writeable
  3. Insert database access data in config.ini (see below -- you don't have to change anything if you want to use sqlite)
  4. You don't have to install the database, it will be created automatically (ensure that your database has enought rights for creating triggers)
  5. Create cronjob for updating feeds and point it to https://yourselfossurl.com/update via wget or curl. You can also execute the cliupdate.php from commandline.

If you obtained selfoss using Git, some more steps will be required. See the development section.

For further questions or on any problem use our support forum: https://selfoss.aditu.de/forum/

CONFIGURATION

  1. Copy defaults.ini to config.ini
  2. Edit config.ini and delete any lines you do not wish to override
  3. Do not delete the [globals] line
  4. See https://selfoss.aditu.de/ for examples

UPDATE

  1. Backup your database and your "data" folder
  2. (IMPORTANT: don't delete the "data" folder) delete all old files and folders excluding the folder "data" and the file config.ini
  3. Upload all new files and folders excluding the data folder (IMPORTANT: also upload the invisible .htaccess files)
  4. Make the folder "public" writeable
  5. Rename your folder /data/icons into /data/favicons
  6. Clean your browser cache
  7. Insert your current database connection and your individual configuration in config.ini. Important: we change the config.ini and add new options in newer versions. You have to update the config.ini too.
  8. The database will be updated automatically (ensure that your database has enought rights for creating triggers)

If you obtained selfoss using Git, some more steps might be required. See the development section.

For further questions or on any problem use our support forum: https://selfoss.aditu.de/forum

SUPPORT

  • Issue tracker for reporting problems and requesting new features
  • Forum for general questions about usage
  • Chat for discussing selfoss development

OPML Import

Selfoss supports importing OPML files. Find the OPML export in the old application, it is usually located somewhere in settings. Then visit the page https://yourselfossurl.com/opml and upload it there.

APPS

Two third party apps are available for Android: Selfoss and Reader For Selfoss.

DEVELOPMENT

Selfoss uses composer for installing external libraries. When you clone the repository you have to issue composer install to retrieve the external sources.

For the client side, you will also need JavaScript dependencies installed by calling npm install in the public directory.

If you want to create a package with all the dependencies bundled, you will additionally require grunt. After installing it, execute npm install in the selfoss directory to obtain the required tasks. Then you can run grunt command to produce a zipball. As a bonus, you can also use grunt install as a shortcut for installing the selfoss dependencies described above.

Every patch is expected to adhere to our coding style, which is checked automatically by Travis. You can install the checkers locally either with your package manager or by calling utils/install-phars.sh, and then run the checks using grunt check before submitting a pull request.

CREDITS

Very special thanks to all contributors of pull requests here on github. Your improvements are awesome!!!

Special thanks to the great programmers of this libraries which will be used in selfoss:

Icon Source: http://www.artcoreillustrations.com/