selfoss: The multipurpose rss reader, live stream, mashup, aggregation web application
PHP JavaScript CSS HTML Other
Latest commit c332057 Feb 13, 2017 @jtojnar jtojnar Remove spout_obj key
The key first appeared in the initial commit
(045dd9b)
but it does not look like it was used anywhere apart from the OPML
controller. To make future changes easier, I am removing it.
Permalink
Failed to load latest commit information.
_docs Remove Google Reader mentions Feb 4, 2017
controllers Remove spout_obj key Feb 17, 2017
daos Remove spout_obj key Feb 17, 2017
data update subproject Apr 15, 2016
helpers Merge pull request #845 from jtojnar/composer Feb 4, 2017
libs Use composer for dependency management Jan 22, 2017
public fix selfoss.filter.type not set from the hash Feb 12, 2017
spouts Improve error reporting for reddit spout Feb 5, 2017
templates use seek pagination instead of offset Feb 12, 2017
utils Add script for deploying commit builds to Bintray Feb 15, 2017
.gitignore Remove the vendor directory Feb 5, 2017
.gitmodules Use a submodule to reference the files of ftrss Oct 9, 2014
.htaccess migrate .htaccess syntax to aapche 2.4 (#722) Dec 28, 2016
.travis.yml Add GitHub release deployment Feb 15, 2017
README.md Add script for deploying commit builds to Bintray Feb 15, 2017
cliupdate.php rename CLI update script (Fix #587) Jun 5, 2015
common.php Use composer for autoloading Jan 22, 2017
composer.json Use our own copy of TwitterOAuth so it could be installed on PHP 5.4 Feb 13, 2017
composer.lock Use our own copy of TwitterOAuth so it could be installed on PHP 5.4 Feb 13, 2017
defaults.ini Do not require database port configuration Jan 13, 2017
gruntfile.js Use composer for dependency management Jan 22, 2017
index.php show error upon invalid tag, source id, section or subsection Feb 12, 2017
package.json Use composer for dependency management Jan 22, 2017
run.php * fix a few smaller issues Jun 29, 2013

README.md

selfoss

Copyright (c) 2015 Tobias Zeising, tobias.zeising@aditu.de
http://selfoss.aditu.de
Licensed under the GPLv3 license
Version 2.17-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.

For further questions or on any problem use our support forum: http://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 http://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. Delete the files /public/all-v.css and /public/all-v.js
  7. Clean your browser cache
  8. 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.
  9. The database will be updated automatically (ensure that your database has enought rights for creating triggers)

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

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

A third party app is available for Android: 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.

Additionally, git submodules are used for obtaining fultextrss filters. When you clone the repository you have to issue a git submodule init as well as a git submodule update to retrieve them.

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/