All Projects → fossar → Selfoss

fossar / Selfoss

Licence: gpl-3.0
multipurpose rss reader, live stream, mashup, aggregation web application

Programming Languages

PHP
23972 projects - #3 most used programming language
javascript
184084 projects - #8 most used programming language
SCSS
7915 projects
python
139335 projects - #7 most used programming language

Projects that are alternatives of or similar to Selfoss

Php Censor
PHP Censor is an open source self-hosted continuous integration server for PHP projects.
Stars: ✭ 619 (-70.1%)
Mutual labels:  self-hosted, hacktoberfest
Friendica Addons
Addons for Friendica
Stars: ✭ 94 (-95.46%)
Mutual labels:  self-hosted, hacktoberfest
Wallabag
wallabag is a self hostable application for saving web pages: Save and classify articles. Read them later. Freely.
Stars: ✭ 6,392 (+208.79%)
Mutual labels:  self-hosted, hacktoberfest
Onpremise
Sentry, feature-complete and packaged up for low-volume deployments and proofs-of-concept
Stars: ✭ 4,558 (+120.19%)
Mutual labels:  self-hosted, hacktoberfest
Atheos
A self-hosted browser-based cloud IDE, updated from Codiad IDE
Stars: ✭ 144 (-93.04%)
Mutual labels:  self-hosted, hacktoberfest
Appwrite
Appwrite is a secure end-to-end backend server for Web, Mobile, and Flutter developers that is packaged as a set of Docker containers for easy deployment 🚀
Stars: ✭ 14,592 (+604.93%)
Mutual labels:  hacktoberfest, self-hosted
Oblecto
Oblecto is a media server, which streams media you already own, and is designed to be at the heart of your entertainment experience. It runs on your home server to index and analyze your media such as Movies and TV Shows and presents them in an interface tailored for your media consupmtion needs.
Stars: ✭ 67 (-96.76%)
Mutual labels:  self-hosted, hacktoberfest
defe
devfeed is a Tech feed Aggregator for Developers & Tech Enthusiasts
Stars: ✭ 28 (-98.65%)
Mutual labels:  aggregator, rss-reader
Raven Reader
📖 All your articles in one place. Beautiful.
Stars: ✭ 2,040 (-1.45%)
Mutual labels:  hacktoberfest, rss-reader
Inertia
✈️ Effortless, self-hosted continuous deployment for small teams and projects
Stars: ✭ 133 (-93.57%)
Mutual labels:  self-hosted, hacktoberfest
Grouparoo
🦘 The Grouparoo Monorepo - open source customer data sync framework
Stars: ✭ 334 (-83.86%)
Mutual labels:  self-hosted, hacktoberfest
Commafeed
Google Reader inspired self-hosted RSS reader.
Stars: ✭ 1,842 (-11.01%)
Mutual labels:  self-hosted, rss-reader
Freshrss
A free, self-hostable aggregator…
Stars: ✭ 3,793 (+83.24%)
Mutual labels:  self-hosted, rss-reader
Liferea
Liferea (Linux Feed Reader), a news reader for GTK/GNOME
Stars: ✭ 612 (-70.43%)
Mutual labels:  hacktoberfest, rss-reader
Freki
🐺 Malware analysis platform
Stars: ✭ 285 (-86.23%)
Mutual labels:  self-hosted, hacktoberfest
Lite Reader
self-hosted Lightweight News Reader
Stars: ✭ 30 (-98.55%)
Mutual labels:  self-hosted, rss-reader
osmosfeed
Turn GitHub into an RSS reader
Stars: ✭ 839 (-59.47%)
Mutual labels:  rss-reader, self-hosted
RSS-to-Telegram-Bot
A Telegram RSS bot that cares about your reading experience
Stars: ✭ 482 (-76.71%)
Mutual labels:  rss-reader, self-hosted
Goodwork
Self hosted project management and collaboration tool powered by TALL stack
Stars: ✭ 1,730 (-16.43%)
Mutual labels:  self-hosted, hacktoberfest
Photoprism
Photos App powered by Go and Google TensorFlow 🌈
Stars: ✭ 17,946 (+766.96%)
Mutual labels:  hacktoberfest, self-hosted

selfoss 2.19-SNAPSHOT

selfoss is a multipurpose RSS reader and feed aggregation web application. It allows you to easily follow updates from different web sites, social networks and other platforms, all in single place. It is written in PHP, allowing you to run it basically anywhere.

For more information visit our web site.

Download

Installation

  1. Upload all files of this directory (IMPORTANT: also upload the invisible .htaccess files).
  2. Make the directories data/cache, data/favicons, data/logs, data/thumbnails and data/sqlite writeable.
  3. Insert database access data in config.ini (see below). You do not need to change anything if you want to use SQLite.
  4. You do not need to create the database tables, they will be created automatically (ensure that your database user is allowed to create triggers).
  5. Create cronjob or systemd timer for updating feeds and point it to https://yourselfossurl.com/update via wget or curl. You can also execute the cliupdate.php from command line.

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

No configuration is needed to use selfoss but you can customize the settings as follows:

  1. Rename config-example.ini to config.ini.
  2. Edit config.ini and delete any lines you do not wish to override.
  3. See https://selfoss.aditu.de/ for examples.

Update

  1. Backup your database and your data/ directory.
  2. (IMPORTANT: do NOT delete the data/ directory) delete all old files and directories excluding the directory data/ and the file config.ini
  3. Upload all new files and directories excluding the data/ directory (IMPORTANT: also upload the invisible .htaccess files).
  4. Consult the NEWS file to learn about backwards incompatible changes.
  5. Clean your browser cache.
  6. 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.
  7. The database will be updated automatically (ensure that your database user is allowed to create 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

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.

Third-party Apps

We recommend Reader For Selfoss for Android devices.

Development

Selfoss uses composer and npm 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 assets directory. You can use npm run install-dependencies as a shortcut for installing both sets of dependencies.

We use Parcel (installed by the command above) to build the client side of selfoss. Every time anything in assets directory changes, you will need to run npm run build for the client to be built and installed into the public directory. When developing, you can also use npm run dev; it will watch for asset changes, rebuild the bundles as needed, and reload selfoss automatically. Upon switching between npm run dev and npm run build, you may need to delete assets/.cache.

If you want to create a package with all the dependencies bundled, you can run npm run dist command to produce a zipball.

Every patch is expected to adhere to our coding style, which is checked automatically by CI. You can install the checkers locally using npm run install-dependencies, and then run the checks using npm run check before submitting a pull request. There is also npm run fix, that will attempt to fix the formatting.

Credits

selfoss was created by Tobias Zeising, and the source code is licensed under the GNU General Public licence version 3, or (at your option) any later version.

Some parts of the source code can be licensed under version 3 only, we are currently trying to resolve it.

The package with bundled dependencies might be distributed under version 3 only.

Very special thanks to all contributors of pull requests here on GitHub, as well as translators on Weblate. Your improvements are awesome!

Special thanks to the great programmers of these libraries used by selfoss:

Icon made by http://blackbooze.com/

Package repository hosting is graciously provided by Cloudsmith. Cloudsmith is the only fully hosted, cloud-native, universal package management solution, that enables your organization to create, store and share packages in any format, to any place, with total confidence.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].