Revenue Notify (Polar Edition)

Note: This repository contains only release binaries. Source code is maintained privately.

Desktop notifications and revenue tracking for Polar.sh creators. Monitor your orders and subscriptions in real-time from your menu bar.

⬇️ Download

Get the latest version from the Releases page.

System Requirements

• macOS: 10.13 (High Sierra) or later
• Windows: Windows 10 or later (64-bit)

📦 Installation

macOS

1. Download the .dmg file:
   • Intel Macs: Revenue-Notify-Polar-Edition-[version].dmg
   • Apple Silicon (M1/M2/M3): Choose the ARM64 version for best performance
2. Open the DMG file
3. Drag the app to your Applications folder
4. First launch: Right-click the app and select "Open" to bypass Gatekeeper
5. Enter your Polar.sh API access key in Settings

Windows

1. Download Revenue-Notify-Polar-Edition-Setup-[version].exe
2. Run the installer
3. Follow the installation wizard
4. Launch from Start Menu or Desktop shortcut
5. Enter your Polar.sh API access key in Settings

Portable Version (Windows)

Don't want to install? Download the portable .exe - no installation required!

✨ Features

🔔 Notifications & Monitoring

• Instant desktop notifications when you receive new orders and subscriptions
• Color-coded menu bar icon that changes based on your activity:
  • Gray: Quiet - no new events
  • Green: New order received!
  • Yellow: New subscription started
  • Blue: Payout processed
• Custom sound alerts - Choose from 15 notification sounds or disable sounds completely
• Flexible refresh intervals - Check for updates every 30 seconds to 30 minutes based on your preference

💰 Revenue Dashboard

• Today's earnings displayed prominently at the top
• Date range filters - View revenue for Today, Yesterday, This Week, This Month, or Last Month
• Automatic platform fee calculation - See exactly what you'll receive after Polar's fees
• Real-time updates - Revenue recalculates as you select different date ranges
• Connection status - Always know when you're online and when data was last refreshed

📊 Detailed Event Information

Click any event to see complete details:

Customer Details:

• Customer name, email, and avatar (with fallback to initials)
• One-click email copying
• Direct links to view the customer on Polar.sh

Transaction Breakdown:

• Payment status (Paid, Pending, Failed, or Refunded)
• Invoice number and date/time
• Itemized amounts: subtotal, discounts, tax, and total
• Platform fees and net amount (what you actually receive)
• Seat count for seat-based pricing
• Refund amounts when applicable

Subscription Information:

• Billing frequency (Monthly, Yearly, or custom intervals)
• Start date and next billing date
• Renewal amount
• Trial status and end date
• Cancellation details if scheduled to cancel

Quick Actions:

• Open the order or subscription on Polar.sh
• View customer profile on Polar.sh
• Copy customer email to clipboard

🎨 Beautiful Interface

• 40+ themes including Light, Dark, Nord, Dracula, Synthwave, Cyberpunk, and many more
• Smooth animations throughout the app
• Privacy mode - Blur sensitive information with one click (perfect for streamers)
• Automatic streamer detection - Privacy mode activates automatically when OBS is running
• Pin window - Keep the dashboard visible while you work (available with license)
• Smart positioning - Popup appears near your menu bar/system tray regardless of screen position

🔐 License & Trial

• 14-day free trial - Full access to all features when you first install
• Simple activation - Enter your license key from Polar.sh to continue after trial
• Multiple devices - Activate on several computers based on your license tier
• Licensed features unlocked:
  • Connect multiple Polar.sh accounts
  • Remove trial limitations

🔄 Auto-Updates

• Automatic update checking when the app starts
• Background downloads - Updates download while you work
• Progress tracking - See download progress in the status bar
• One-click install - Click to restart and install when ready
• Pre-release access - Opt-in to receive beta versions and early features

⚙️ Customization Options

• Multiple Polar accounts - Switch between different organizations (with license)
• Custom account names - Label accounts for easy identification
• 40+ timezone options - Display times in your timezone or use Polar's server time
• Notification preferences - Enable/disable notifications for orders and subscriptions separately
• Launch at startup - Automatically start the app when your computer boots
• Hardware acceleration toggle - Disable if you experience graphics issues on Windows

🛡️ Privacy & Security

• Local storage only - All your data stays on your device
• Secure token storage - Your Polar.sh API key is encrypted
• No tracking - Zero analytics, no data collection
• Direct connection - Only communicates with Polar.sh, no third parties
• OBS detection - Automatically protects your privacy when streaming

🚀 Quick Start

1. Install the app for your platform
2. Launch Revenue Notify
3. Open Settings from the menu bar icon
4. Add your Polar.sh API Access Key:
   • Go to Polar.sh Settings → API
   • Create a new Personal Access Token
   • Copy and paste it into Revenue Notify
5. Start monitoring your revenue! 🎉

🔄 Staying Updated

Revenue Notify automatically checks for updates when you start the app. New versions download in the background, and you'll see a notification when an update is ready to install.

Update Channels

Stable Releases (Default)

• Production-ready versions only
• Thoroughly tested and reliable
• Recommended for most users

Pre-Release Updates (Optional)

Want early access to new features? You can opt-in to receive beta versions:

1. Open Settings from the menu bar icon
2. Check "Receive pre-release updates (beta/RC versions)"
3. Restart the app

You'll now receive beta versions and release candidates before they're released to everyone!

Portable Version Updates

If you're using the portable Windows version (the .exe file that doesn't require installation), auto-updates are disabled. To update manually:

1. Download the latest portable version from the Releases page
2. Close the app
3. Replace your current .exe file with the new one

📋 Changelog

See individual release notes for detailed changelogs.

🐛 Bug Reports & Feature Requests

Found a bug or have an idea?

Use the feedback button within the app or go to our UserJot page.

❓ Frequently Asked Questions

Is this app free?

Revenue Notify includes a 14-day free trial with full access to all features. After the trial period, you'll need to purchase a license key to continue using the app.

Is my data secure?

Absolutely! All your data is stored locally on your device. The app only communicates directly with Polar.sh using your API access token. We don't collect any analytics, and your information is never sent to third-party servers.

Can I use it on multiple computers?

Yes! Each license supports multiple device activations (the exact number depends on your license tier). Simply enter your license key on each device you want to use.

Does it work offline?

The app needs an internet connection to fetch new data from Polar.sh. However, once data is loaded, it's cached locally so you can still view your dashboard offline.

How do I get a license?

Purchase a license through RevenueNotify.com. You'll receive a license key that you can activate in the app's Settings under the License tab.

What happens when my trial ends?

After 14 days, you'll need to activate a license to continue using the app. Your data and settings are preserved, so once you activate a license, everything will work exactly as before.

🛠️ Troubleshooting

macOS: "App can't be opened because it's from an unidentified developer"

This security warning appears because the app isn't notarized by Apple yet.

How to fix: Right-click (or Control-click) the app icon and select "Open" instead of double-clicking. You'll see a warning dialog—click "Open" again to launch the app.

Windows: SmartScreen warning

Windows SmartScreen may show a warning when you first run the app.

How to fix: Click "More info" in the warning dialog, then click "Run anyway". This warning appears because the app isn't code-signed yet, but it's completely safe to use.

"Disconnected" or "Failed to connect"

If you see a disconnected status in the app:

How to fix:

1. Check that your internet connection is working
2. Verify your Polar.sh API access token is correct in Settings
3. Make sure your organization name is entered correctly
4. Try creating a new API token on Polar.sh and updating it in the app

Notifications not appearing

If you're not seeing desktop notifications:

How to fix:

1. Check your system notification permissions:
   • macOS: System Settings → Notifications → Revenue Notify
   • Windows: Settings → System → Notifications → Revenue Notify
2. Verify notifications are enabled in the app's Settings
3. Make sure the app is actively checking for updates (check polling interval in Settings)

App not detecting updates

How to fix:

1. Check your internet connection
2. Verify you're not using the portable version (it doesn't auto-update)
3. Try restarting the app to force an update check
4. Manually check the Releases page for the latest version

Graphics issues or crashes on Windows

If the app crashes or shows visual glitches:

How to fix:

1. Open Settings (if you can launch the app)
2. Enable "Disable hardware acceleration"
3. Restart the app

If you can't open Settings, you may need to reinstall the app.

📄 License

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

🙏 Credits

Built by Sébastien Dumont for the Polar.sh community.

Special thanks to:

• Polar.sh for the amazing platform
• All beta testers and early adopters

Made with ❤️ for Polar.sh creators

🔗 Links

• Website: revenuenotify.com (coming soon)
• Polar.sh: polar.sh
• Report Issues: Use the feedback button in the app or visit the UserJot page.