Go to file
2021-11-01 23:10:53 +08:00
api Automated build for v0.01 2019-03-22 10:17:29 -04:00
cache Automated build for v0.01 2019-03-22 10:17:29 -04:00
classes Apply some customization 2021-11-01 23:10:53 +08:00
css Apply some customization 2021-11-01 23:10:53 +08:00
feed-icons Automated build for v0.01 2019-03-22 10:17:29 -04:00
images Automated build for v0.01 2019-03-22 10:17:29 -04:00
include Apply some customization 2021-11-01 23:10:53 +08:00
install Automated build for v0.01 2019-03-22 10:17:29 -04:00
js Apply some customization 2021-11-01 23:10:53 +08:00
lib Automated build for v0.01 2019-03-22 10:17:29 -04:00
locale Automated build for v0.01 2019-03-22 10:17:29 -04:00
lock Automated build for v0.01 2019-03-22 10:17:29 -04:00
plugins Automated build for v0.01 2019-03-22 10:17:29 -04:00
plugins.local Automated build for v0.01 2019-03-22 10:17:29 -04:00
schema Automated build for v0.01 2019-03-22 10:17:29 -04:00
screenshots Automated build for v0.01 2019-03-22 10:17:29 -04:00
templates Automated build for v0.01 2019-03-22 10:17:29 -04:00
tests Automated build for v0.01 2019-03-22 10:17:29 -04:00
themes Automated build for v0.01 2019-03-22 10:17:29 -04:00
themes.local Automated build for v0.01 2019-03-22 10:17:29 -04:00
utils Automated build for v0.01 2019-03-22 10:17:29 -04:00
vendor Automated build for v0.01 2019-03-22 10:17:29 -04:00
.editorconfig Automated build for v0.01 2019-03-22 10:17:29 -04:00
.gitignore Automated build for v0.01 2019-03-22 10:17:29 -04:00
.gitlab-ci.yml Automated build for v0.01 2019-03-22 10:17:29 -04:00
atom-to-html.xsl Automated build for v0.01 2019-03-22 10:17:29 -04:00
backend.php Automated build for v0.01 2019-03-22 10:17:29 -04:00
config.php-dist Automated build for v0.01 2019-03-22 10:17:29 -04:00
config.test Automated build for v0.01 2019-03-22 10:17:29 -04:00
CONTRIBUTING.md Automated build for v0.01 2019-03-22 10:17:29 -04:00
COPYING Automated build for v0.01 2019-03-22 10:17:29 -04:00
errors.php Automated build for v0.01 2019-03-22 10:17:29 -04:00
index.php Automated build for v0.01 2019-03-22 10:17:29 -04:00
messages.pot Automated build for v0.01 2019-03-22 10:17:29 -04:00
opml.php Automated build for v0.01 2019-03-22 10:17:29 -04:00
PLUGINHOOKS.md Automated build for v0.01 2019-03-22 10:17:29 -04:00
prefs.php Automated build for v0.01 2019-03-22 10:17:29 -04:00
public.php Automated build for v0.01 2019-03-22 10:17:29 -04:00
README.md Automated build for v0.01 2019-03-22 10:17:29 -04:00
register.php Automated build for v0.01 2019-03-22 10:17:29 -04:00
update_daemon2.php Automated build for v0.01 2019-03-22 10:17:29 -04:00
update.php Automated build for v0.01 2019-03-22 10:17:29 -04:00
version Automated build for v0.01 2019-03-22 10:17:29 -04:00

Agriget

Agriget is a fork of Tiny Tiny RSS (TT-RSS) that focuses on a more modern "Feedly styled" UI while retaining all compatibility and updates with and from the TT-RSS backend and mobile applications. While the original features of Agriget were started as a PR to TT-RSS, due to development differences Agriget was instead created to foster an open environment for developers to contribute.



Core differences from TT-RSS include:

  • UI enhancements to include visuals and make view changes and night mode more seamless
  • Greater 12h time support in UI
  • Consolidated data directory for easier deployment in container infrastructures such as Docker

Todo:

  • Refactor full UI including settings screens in CSS Grid
  • Remove requirement for popout top menu
  • Cross platform mobile implementation leveraging new UI

Install

The easiest installation method is to use the prebuilt Docker image located at: https://hub.docker.com/r/nowsci/agriget. The below will set up the containers required for Agriget. You should seperatly set up an nginx instance proxying to agriget:80, or you could open ports to the host.

In your docker-compose.yml:

version: '2.1'

services:

  agriget-mariadb:
    image: mariadb
    container_name: agriget-mariadb
    environment:
      - MYSQL_ROOT_PASSWORD=agriget
      - MYSQL_PASSWORD=agriget
      - MYSQL_DATABASE=agriget
      - MYSQL_USER=agriget
    volumes:
      - /etc/localtime:/etc/localtime:ro
      - ./agriget/mariadb/data/:/var/lib/mysql
    restart: always

  agriget:
    image: nowsci/agriget
    container_name: agriget
    volumes:
      - /etc/localtime:/etc/localtime:ro
      - ./agriget/apache/data:/data
    depends_on:
      - agriget-mariadb
    restart: always

If you do not wish to use Docker, you can follow the standard TT-RSS instructions from https://git.tt-rss.org/fox/tt-rss/wiki/InstallationNotes while substituting the https://github.com/Fmstrat/agriget repo for Tiny Tiny RSS.

Migrating from TT-RSS

Migration from TT-RSS is a fairly straight forward process unless you are running some really custom plugins.

  • Copy your config.php file to Agriget's /data directory.
  • Make the following changes to config.php:
    • Add define('DATA_DIR', 'data');
    • Change define('LOCK_DIRECTORY', 'lock'); to define('LOCK_DIRECTORY', 'data/lock');
    • Change define('CACHE_DIR', 'cache'); to define('CACHE_DIR', 'data/cache');
    • Change define('ICONS_DIR', "feed-icons"); to define('ICONS_DIR', "data/feed-icons");
    • Change define('ICONS_URL', "feed-icons"); to define('ICONS_URL', "data/feed-icons");
    • Ensure define('PLUGINS', ...) includes toggle_sidebar, bookmarklets, close_button as these are required by Agriget

Now Agriget will be pointed at your existing TT-RSS database and function as TT-RSS did before. Please be sure TT-RSS is not running before you start Agriget, and it is highly recommended you run a backup before beginning this process.

Plugins

Looking to develop TT-RSS style plugins? See the Hook Documentation for information on which hooks are available.

Disclaimer

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.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.