Skip to content

πŸ†“ Browser extension to open Medium articles in Freedium for free reading. Adds floating button, right-click menu, and keyboard shortcuts for seamless access to paywalled content.

License

Notifications You must be signed in to change notification settings

Paresh-Maheshwari/Freedium_Extensions

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Freedium Medium Redirector Extension

License: MIT Chrome Web Store Firefox Add-ons

A powerful browser extension that adds a "Free Read" button to Medium articles and other paywalled content, allowing you to open them in Freedium for free reading without restrictions.

✨ Features

🎯 Core Functionality

  • One-click access to Freedium for any Medium article
  • Automatic detection of Medium and Medium-hosted publications
  • Beautiful floating button with modern design
  • SPA support - Works with Single Page Applications
  • Right-click context menu for universal access
  • Keyboard shortcut (Ctrl+Shift+F) for power users

🎨 Customization & Themes

  • Light/Dark themes with auto system detection
  • Customizable button position (4 corners with offset control)
  • Multiple button sizes (Small, Medium, Large)
  • 4 button styles (Gradient, Solid, Minimal, Glass)
  • Entrance animations with customizable timing
  • Live preview of button positioning

βš™οΈ Advanced Settings

  • Comprehensive options page with professional UI
  • Custom site support - Add your own domains
  • Auto-detection toggle for Medium articles
  • Context menu control - Enable/disable right-click menu
  • Debug mode for troubleshooting
  • Keyboard shortcuts management

πŸ”’ Privacy & Performance

  • No data collection or tracking
  • Local storage only for settings
  • Lightweight and fast performance
  • Privacy-focused design

🌐 Supported Sites

  • Medium.com and all Medium-hosted publications
  • Substack.com - Newsletter platforms
  • TowardsDataScience.com - Data science articles
  • InfoSecWriteups.com - Cybersecurity content
  • BetterProgramming.pub - Programming tutorials
  • JavaScript.PlainEnglish.io - JavaScript guides
  • Python.PlainEnglish.io - Python tutorials
  • LevelUp.GitConnected.com - Developer content
  • Blog.DevGenius.io - Tech articles
  • Custom sites - Add your own domains in settings

πŸš€ Installation

Chrome/Edge/Brave/Opera

  1. Download the extension:

    git clone https://github.com/Paresh-Maheshwari/Freedium_Extensions.git
    cd Freedium_Extensions
  2. Load in browser:

    • Open chrome://extensions/ (or edge://extensions/)
    • Enable "Developer mode" (toggle in top right)
    • Click "Load unpacked"
    • Select the Freedium_Extensions folder
    • βœ… Extension installed successfully!

Firefox

  1. Download the extension (same as above)
  2. Load in Firefox:
    • Open about:debugging
    • Click "This Firefox"
    • Click "Load Temporary Add-on"
    • Select the manifest.json file
    • βœ… Extension loaded successfully!

🎯 Usage

Method 1: Floating Button (Automatic)

  1. Navigate to any Medium article
  2. Look for the "Free Read" button (customizable position)
  3. Click the button to open the article in Freedium

Method 2: Right-Click Context Menu (Universal)

  1. Right-click anywhere on any webpage
  2. Select "Open in Freedium" from the context menu
  3. Choose "Open Current Page in Freedium" or "Open Link in Freedium"
  4. The page/link will open in Freedium in a new tab

Method 3: Extension Popup

  1. Click the extension icon in your browser toolbar
  2. Click "Open Current Page in Freedium"
  3. The current page will open in Freedium in a new tab

Method 4: Keyboard Shortcut

  1. Press Ctrl+Shift+F (Windows/Linux) or Cmd+Shift+F (Mac)
  2. The current page will open in Freedium in a new tab

βš™οΈ Settings & Customization

🎨 Theme Settings

  • Dark Theme - Original purple gradient design
  • Light Theme - Clean light gray design
  • Auto Theme - Follows system preference

πŸ“ Button Position

  • 4 Positions: Top-right, Top-left, Bottom-right, Bottom-left
  • Custom Offsets: Horizontal and vertical pixel adjustments
  • Live Preview: See changes in real-time

🎨 Button Appearance

  • 3 Sizes: Small, Medium, Large
  • 4 Styles:
    • Gradient (default purple gradient)
    • Solid (solid purple color)
    • Minimal (outline style)
    • Glass (translucent effect)
  • Animation Toggle: Enable/disable entrance animation

🌐 Site Settings

  • Auto-detect Toggle: Enable/disable Medium detection
  • Show on All Sites: Control button visibility
  • Custom Sites: Add your own domains (one per line)

βš™οΈ Advanced Options

  • Debug Mode: Console logging for troubleshooting
  • Context Menu: Enable/disable right-click menu
  • Button Delay: Customize appearance timing (0-5000ms)
  • Keyboard Shortcuts: Manage shortcut preferences

πŸ› οΈ How It Works

The extension:

  1. Detects when you're on a Medium or supported publication page
  2. Injects a floating "Free Read" button with customizable styling
  3. Redirects to https://freedium.cfd/[original-url] when clicked
  4. Opens the Freedium version in a new tab for seamless reading

🎨 Icons & Design

The extension includes professionally designed icons:

  • icons/icon16.png - 16x16 toolbar icon
  • icons/icon48.png - 48x48 extension manager icon
  • icons/icon128.png - 128x128 Chrome Web Store icon
  • icons/icon.svg - Original SVG source file

Icon Design Features:

  • Purple gradient background representing premium content
  • Unlocked padlock symbolizing free access
  • Green checkmark indicating availability
  • Document lines representing articles

πŸ”§ Development

Project Structure

Freedium_Extensions/
β”œβ”€β”€ manifest.json     # Extension configuration
β”œβ”€β”€ background.js     # Context menu & keyboard shortcuts
β”œβ”€β”€ content.js        # Main content script with settings
β”œβ”€β”€ styles.css        # Button styling & themes
β”œβ”€β”€ popup.html        # Extension popup UI
β”œβ”€β”€ popup.js          # Popup functionality & theme
β”œβ”€β”€ options.html      # Settings page UI
β”œβ”€β”€ options.js        # Settings functionality
β”œβ”€β”€ README.md         # Documentation
β”œβ”€β”€ CHANGELOG.md      # Version history
└── icons/            # Extension icons
    β”œβ”€β”€ icon.svg      # Original SVG
    β”œβ”€β”€ icon16.png    # Small icon
    β”œβ”€β”€ icon48.png    # Medium icon
    └── icon128.png   # Large icon

Building from Source

# Clone the repository
git clone https://github.com/Paresh-Maheshwari/Freedium_Extensions.git
cd Freedium_Extensions

# Load in browser (see installation instructions above)

πŸ› Troubleshooting

Button Not Appearing

  • Check if you're on a supported site
  • Verify auto-detection is enabled in settings
  • Try refreshing the page
  • Check browser console for errors (enable debug mode)

Extension Not Loading

  • Ensure all files are in the same folder
  • Check that manifest.json is valid JSON
  • Make sure Developer mode is enabled
  • Try reloading the extension

Settings Not Saving

  • Check browser permissions for storage
  • Try resetting to default settings
  • Ensure popup blockers aren't interfering

Freedium Not Working

  • Verify the URL format: https://freedium.cfd/[original-url]
  • Some articles may not be available on Freedium
  • Try the original Freedium website directly
  • Check if the article is publicly accessible

πŸ”’ Privacy & Security

This extension:

  • βœ… Only runs on specified Medium-related domains
  • βœ… Does not collect or store any personal data
  • βœ… Does not track your browsing activity
  • βœ… Only accesses the current page URL when you click the button
  • βœ… No external servers - all processing is local
  • βœ… Open source - code is fully transparent
  • βœ… Local storage only - settings stored on your device

🀝 Contributing

Contributions are welcome! Here's how you can help:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Ideas for Contributions:

  • 🌐 Add support for more publications
  • 🎨 Improve the design or functionality
  • πŸ› Fix bugs or issues
  • πŸ“š Improve documentation
  • 🌍 Add internationalization support
  • ⚑ Performance optimizations

πŸ“ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ‘¨β€πŸ’» Author

Paresh Maheshwari

πŸ™ Acknowledgments

  • Freedium - For providing the free Medium reading service
  • Medium - For creating great content (even if it's behind paywalls)
  • The open-source community for inspiration and tools

⭐ Support

If you find this extension helpful, please:

  • ⭐ Star this repository
  • πŸ› Report any bugs or issues
  • πŸ’‘ Suggest new features
  • πŸ”„ Share with others who might find it useful

πŸ“Š Stats

GitHub stars GitHub forks GitHub issues


Disclaimer: This extension is for educational purposes. Please respect content creators and consider supporting them directly when possible. The extension simply redirects to Freedium, which is a third-party service.

About

πŸ†“ Browser extension to open Medium articles in Freedium for free reading. Adds floating button, right-click menu, and keyboard shortcuts for seamless access to paywalled content.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published