Skip to content

isabelroses/izrss

Repository files navigation

izrss

An RSS feed reader for the terminal.

 

demo

Usage

Ensure you have a ~/.config/izrss/urls file, or your systems eqivelent, with the following structure:

https://isabelroses.com/rss.xml
https://uncenter.dev/feed.xml

Then run izrss to read the feeds.

Customization

The main bulk of customization is done via the ~/.config/izrss/config.toml file. You can find an example file here config.toml.

The rest of the config is done via using the environment variables GLAMOUR_STYLE. For a good example see: catppuccin/glamour

Nix

Installation with flakes and home-manager

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";

    home-manager = {
      url = "github:nix-community/home-manager";
      inputs.nixpkgs.follows = "nixpkgs";
    };

    izrss.url = "github:isabelroses/izrss";
  };

  outputs = { self, nixpkgs, home-manager, izrss }: {
    homeConfigurations."user@hostname" = home-manager.lib.homeManagerConfiguration {
      modules = [
        home-manager.homeManagerModules.default
        {
          programs.izrss = {
            enable = true;
            urls = [
              "https://isabelroses.com/rss.xml"
              "https://uncenter.dev/feed.xml"
            ];
          };
        }
      ];
    };
  }
}

Installation with flakes

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    izrss.url = "github:isabelroses/izrss";
  };

  outputs = { self, nixpkgs, izrss }: {
    nixosConfigurations.example = nixpkgs.lib.nixosSystem {
      system = "x86_64-linux";
      modules = [{
        environment.systemPackages = [
          inputs.izrss.packages.${pkgs.system}.default
        ];
      }];
    };
  }
}