README.md

Youlag
Video extension for FreshRSS

About

Youlag delivers a video-focused browsing experience for your YouTube RSS feeds in FreshRSS, with a sleek theme and extra features.

While it also supports regular feeds, this setup is tailored specifically for video content. Feel free and set up a separate instance for your video feeds if needed.

Table of Content

• Features
• Install
• Additional Resources
• Contribution
• Attributions

Features

• ⭐ Optimized for Video Viewing
  • Browse your YouTube, Invidious, Piped RSS subscriptions with ease.
  • Clean, familiar video platform layout.
  • Fullscreen viewing for videos and feed items.
  • Quickly exit videos with Esc key.
  • Shortcuts for external viewing: "Invidious", "YouTube", or "YouTube embed view" (for less distraction).
  • Dark mode.
• 🖥️ Desktop & Mobile
  • Reponsive design.
  • Redesigned menus for better one-handed navigation.
  • Improved readability and legibility across devices.
• 📺 Features Offered by FreshRSS:
  • Subscribe to YouTube creators without an account.

Planned

• Minimize video, for background playback while browsing.
• Local video queue, but without autoplay due to CORS limitation.
• Clickable links in video descriptions.
• Convert to an actual FreshRSS extension, with options for customizing the view and features.
  • Ability to specify which category to apply the video grid on, with the intention to only affect video feeds.

Install

1. Download the latest release here.

2. In FreshRSS, go to Settings > Configuration: Display and use these settings:

   • Theme: "Mapco — By: Thomas Guesnon".

3. Go to Settings > Extensions and click the gear (⚙️) icon for each extension:

   • User JS: Copy the content from script.js paste it into the text field, and click "Submit".
   • User CSS: Copy the content from theme.css, paste it into the text field, and click "Submit".
   • Enable the extensions.

Note

User JS and User CSS extensions now come with FreshRSS by default.

If missing, get them from the official extensions repository.

Additional Resources

• "Invidious Video Feed" FreshRSS extension by tunbridgep.
  • If you prefer to use Invidious instead.
• "YouTubeChannel2RssFeed" FreshRSS extension by cn-tools.
  • Converts YouTube channel links ending with @channelName into valid RSS links when adding new feeds.

Contribution

1. Fork and make changes to the dev branch.
2. Install dependencies: npm i.
3. Make styling changes to the SASS file at src/theme.scss opposed to the compiled theme.css file.
   • Run npm run watch-css to compile src/theme.scss to theme.css.
   • Learn more about SASS here.
4. For structural and functional changes to the Youlag video modal, edit script.js in plain JavaScript.

Attributions

• Icons used/remixed: SVG Repo, krystonschwarze, phosphor, Solar Icons, Dazzle UI, n3r4zzurr0/svg-spinners.
• Tools: SVGOptimizer, b64.io.
• Featured channels on top image: Novaspirit Tech, Hardware Haven.
  • Edit 2025-02-05: Rest in peace Don (Novaspirit Tech), thank you for your contribution to the community.

License

GNU General Public License v3.0