EveningSafari 🌙

EveningSafari is a locally-run, free Safari Web Extension that turns any website into a dark mode. It works seamlessly and locally without any App Store installation, directly using Safari's built-in extension permissions.

It provides two dark mode features:

1. Filter (Default): A highly performant mode that quickly applies CSS inversion magic while carefully un-inverting images and videos to look natural.
2. Dynamic: A structural dark mode that actively parses the website's stylesheet and restyles background colors, borders, and text intelligently on the fly.

Structure

EveningSafari doesn't need external dependencies.

• extension/ – Contains all the HTML, JavaScript, and CSS web assets, including the Manifest V3.
• EveningSafari.xcodeproj – The macOS Xcode project wrapper required by Safari to run Web Extensions locally.

---

🚀 Installation & Build Instructions

Since EveningSafari won't be submitted to the Mac App Store, you can build and run it locally on your MacBook forever for free. Follow these steps:

1. Prerequisites

• You must have Xcode installed from the Mac App Store (or Apple Developer portal) to build the wrapper once.

2. Enable Safari Developer Tools

To allow local extensions:

1. Open Safari.
2. Go to Safari > Settings... > Advanced.
3. Check Show features for web developers (Or "Show Develop menu in menu bar" on older versions).
4. Go to Develop > Allow Unsigned Extensions and click it to enable (you'll need to enter your Mac password). (Note: You'll have to check this "Allow Unsigned Extensions" option each time you completely quit and restart Safari).

3. Build the Extension

1. Open the EveningSafari.xcodeproj file in Xcode.
2. In the top-left corner of the Xcode window, ensure the target is set to EveningSafari and your Mac is selected.
3. Click the Play button ▶️ (Product > Run), or press Cmd + R.
4. This will compile the minimal wrapper app and launch a window saying the extension is ready. You can close this window but keep the background app running or installed.

4. Enable the Extension in Safari

1. Open Safari > Settings... > Extensions.
2. Find EveningSafari in the left sidebar and check the box to turn it on.
3. Safari may ask for website permissions. You should click "Always Allow on Every Website" so EveningSafari can automatically inject the dark mode script across your browsing sessions.
4. You'll now see the EveningSafari crescent moon icon 🌙 in your Safari toolbar!

---

Usage

• Click the EveningSafari toolbar icon to open the popup.
• You can toggle dark mode On/Off for the current site or Globally.
• Use the mode selector to switch between Filter (faster) and Dynamic (smarter).
• Adjust the Brightness, Contrast, and Sepia sliders to fit your visual preference — changes apply instantly!

PRs

#VibedPRsWelcome