Skip to content

tryallthethings/freshvibes

Repository files navigation

FreshVibes: an iGoogle / Netvibes-like extension for FreshRSS

A modern, customizable dashboard view extension for FreshRSS that looks and feels like iGoogle / NetVibes.
With the recent shutdown of Netvibes, I was looking for an alternative. FreshRSS was recommended to me, but it unfortunately lacked the dashboard I was used to. So I created my own extension that brings the functionality to FreshRSS.

Dashboard in dark and category tabs mode

Dashboard in dark and category tabs mode

Dashboard in light and custom tabs mode

Dashboard in light and custom tabs mode

Article excerpt in modal

Article excerpt in modal

✨ Features

πŸ“Š Dashboard Views

The extension offers two different view modes:

  • Custom Tabs Mode: Organize your feeds into custom tabs with drag-and-drop functionality
  • Category Tabs Mode: Automatically create tabs based on your existing FreshRSS categories

🎨 Customization Options

  • Multi-column Layouts: Configure 1-6 columns per tab for optimal feed organization
  • Tab Customization:
    • Custom icons/emojis for each tab
    • Configurable background colors with automatic contrast adjustment
    • Rename tabs with double-click
    • Unique URL slugs allow linking directly to specific tabs
Tab customization options screenshot
  • Feed Settings:
    • Adjust the number of articles shown for each feed and freely size the feed height
    • Multiple font sizes for each feed
    • Custom header colors for each feed
    • Different feed entry display modes (tiny, compact, detailed), relative and absolute feed entry post date / time option
    • Mark feed entries read / unread and favorite them via mouseover menu
Feed customization options screenshot

πŸ“± User Experience

  • Article Preview Modal: Quickly peek into any article with a modal
  • Auto-refresh: Optional AJAX-powered auto-refresh
  • Responsive Design: Partly mobile-optimized layout
  • Multi-language Support: Available in many languages (English, German and French currently maintained, rest is machine translated. If you want to help, check Contributing
  • and a lot more options to customize your experience

πŸ“‹ Requirements

  • FreshRSS 1.27.0 or higher
  • Modern web browser with JavaScript enabled

πŸš€ Installation

  1. Download the latest Release
  2. Extract the .ZIP-file and copy / upload the contents to /path/to/freshrss/extensions/

or via command line:

  1. Navigate to your FreshRSS extensions folder:
cd /path/to/freshrss/extensions/
  1. Clone this repository
git clone https://github.com/tryallthethings/freshvibes.git
  1. In FreshRSS:
    • Go to Configuration β†’ Extensions
    • Find "Fresh Vibes View" in the list
    • Click Enable

🎯 Usage

Getting Started

  1. After enabling the extension, click the Freshvibes logo icon in the reading modes toolbar
  2. Choose your preferred view mode in the extension settings.

Managing Tabs

  • Add Tab: Click the + button (only available in custom tabs dashboard mode)
  • Rename Tab: Double-click the tab name (only available in custom tabs dashboard mode)
  • Configure Tab: Click the β–Ύ arrow to access:
    • Column layout (1-6 columns)
    • Tab icon and color
    • Tab header background color

Configuring Feeds

  • Click the βš™οΈ icon on any feed to adjust:
    • Feed article limit
    • Feed font size
    • Feed header color
    • Drag feeds between columns or tabs to reorganize

βš™οΈ Configuration

Access the extension settings through Configuration β†’ Extensions β†’ Fresh Vibes View:

  • Dashboard Mode: Choose between Custom Tabs or Category Tabs
  • Auto-refresh: Enable/disable automatic refresh
  • Refresh Interval: Set refresh time in minutes (default: 15)
  • Date Format: Customize date display format (e.g., Y-m-d H:i)

🀝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. If you'd like to help translate FreshVibes, join our project on Crowdin.

πŸ› Issues

If you encounter any bugs or have feature requests, please open an issue.

πŸ‘ Acknowledgments

  • Inspired by the classic Netvibes dashboard interface
  • Built for the FreshRSS community
  • Uses Sortable.js for drag-and-drop functionality

About

Netvibes / iGoogle like view for FreshRSS

Resources

License

Stars

Watchers

Forks

Sponsor this project

  •  

Packages

No packages published

Contributors 5