Apply base16 color schemes to customize the appearance of your macOS windows.
Note: This is a custom macOS tweak that requires disabling System Integrity Protection (SIP) to function properly.
 |  |
|---|---|
 |  |
- Apply customizable color tints to any macOS window
- Standalone TintedMac application for easy configuration
- More than 290 built-in color schemes with customizable configuration options
- Blacklist support for excluding specific applications and processes
Configuration is stored in ~/.config/tinted-mac/config.toml
You can modify settings using a text editor such as nvim, or utilize the TintedMac GUI configurator to choose between light and dark theme variants.
Deploy TintedMacInject to /var/ammonia/core/tweaks/TintedMac.dylib
Deploy TintedMacInject's blacklist to /var/ammonia/core/tweaks/TintedMac.dylib.blacklist
Place TintedMacHelper in /usr/local/bin.
Set up the TintedMacHelper Launch Agent in ~/Library/LaunchAgents.
This project uses a Makefile for build automation and contains the following targets:
- TintedMac: Main GUI theme customizer application
- TintedMacInject: SIMBL-compatible dynamic library for system-wide injection
- TintedMacHelper: Helper utility for privileged operations
Use the provided Makefile for all build operations:
# Build all targets
make build
# Build individual targets
make tintedmac # Build TintedMac GUI application
make tintedmacinject # Build TintedMacInject dynamic library
make tintedmachelper # Build TintedMacHelper utility# Run the TintedMac GUI application
make run
# Install tweak and helper to system
make install
# Uninstall everything from system
make uninstall
# Show all available targets
make help# Build the project first, then:
./package.shThis creates tintedmac.pkg which can be distributed and installed on other systems.
Note: System Integrity Protection (SIP) must be disabled for TintedMac to function properly.
Required: Ammonia must be installed for TintedMac to work. Ammonia provides the SIMBL-compatible injection framework that TintedMac relies on.
Edit TintedMacInject.dylib.blacklist to exclude specific applications:
# Add bundle identifiers of apps to exclude
com.apple.finder
com.example.myapp
Alacritty
Finder
...
Project Structure
TintedMac/
├── TintedMac/ # Main GUI application
│ ├── AppDelegate.swift # Application delegate
│ ├── AppearanceManager.swift # Appearance management
│ ├── ColorEditorView.swift # Color picker interface
│ ├── Config.swift # Configuration management
│ ├── CustomBase24Loader.swift # Theme loading utilities
│ ├── main.swift # Application entry point
│ ├── SettingsView.swift # Settings interface
│ ├── ThemeBrowserView.swift # Theme browser
│ ├── ThemeCustomizeView.swift # Theme customization
│ ├── ThemeManager.swift # Theme management logic
│ ├── ThemePreviewWindow.swift # Preview functionality
│ ├── TintManager.swift # Core tinting logic
│ └── ViewController.swift # Main window controller
├── TintedMacInject/ # SIMBL injection library
│ └── TintedMacInject.swift # Injection implementation
├── TintedMacHelper/ # Helper utility
│ ├── main.swift
│ └── TintedMacProtocol.swift
├── Shared/ # Shared components
│ ├── TintedMacConstructor/ # Constructor utilities
│ │ ├── constructor.c
│ │ └── include/
│ └── WindowAdditions/ # NSWindow extensions
│ ├── WindowAdditions.mm # Objective-C++ implementation
│ └── include/
├── Resources/ # Configuration files and assets
│ ├── com.aspauldingcode.TintedMac.helper.plist # LaunchAgent configuration
│ └── TintedMacInject.dylib.blacklist ``````````# Application blacklist
├── Makefile # Build automation (primary build system)
├── package.sh # Package creation script
└── Preview*.png # Screenshot previews
Contributions are welcome! Please feel free to submit pull requests or open issues for bugs and feature requests.
This project is licensed under the MIT License - see the LICENSE file for details.
Made by Alex Spaulding (aspauldingcode)
✨ Built with love for the macOS tweaking community ✨