https://github.com/rollecode/thelounge-native-mac-app
Native Mac app for The Lounge. (macOS Tahoe)
https://github.com/rollecode/thelounge-native-mac-app
Last synced: 27 days ago
JSON representation
Native Mac app for The Lounge. (macOS Tahoe)
- Host: GitHub
- URL: https://github.com/rollecode/thelounge-native-mac-app
- Owner: rollecode
- Created: 2026-01-16T17:08:37.000Z (4 months ago)
- Default Branch: master
- Last Pushed: 2026-01-20T12:02:31.000Z (4 months ago)
- Last Synced: 2026-05-02T13:33:34.072Z (28 days ago)
- Language: Swift
- Size: 174 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
The Lounge - Native macOS app (unofficial)
## Overview
A native macOS wrapper for [The Lounge](https://thelounge.chat/) IRC client with native notifications, customizable appearance, and full macOS integration. Looking for Linux version? Check out [thelounge-native-linux-app](https://github.com/ronilaukkarinen/thelounge-native-linux-app).
## Requirements
- macOS 26 (Tahoe) or later
- Xcode 16 or later (for building)
- A running instance of The Lounge web client
## Features
### Native notifications
- Bridges web Push API to native macOS notifications
- Configurable notification sounds
- Works even when the app is in the background
### Customizable titlebar
- Set any color for the window titlebar via Settings (Cmd+,)
- Persists across app restarts
### Other features
- Zoom controls (Cmd+/-, Cmd+0)
- External links open in default browser
- Spell check disabled in input fields
- Full dark mode support
- Works correctly as a login item
## Building
### Prerequisites
1. Install Xcode from the Mac App Store
2. Run `xcode-select --install` in Terminal
### Build steps
```bash
git clone https://github.com/ronilaukkarinen/thelounge-native-mac-app.git
cd thelounge-native-mac-app
xcodebuild -scheme TheLoungeApp -configuration Release -derivedDataPath build build
cp -R "build/Build/Products/Release/The Lounge.app" /Applications/
```
## Configuration
### Changing the server URL
Edit `TheLoungeApp/ContentView.swift` and change the URL:
```swift
WebView(url: URL(string: "https://your-lounge-instance.com")!)
```
Then rebuild the app.
### Settings
Open Settings with Cmd+, to configure:
- Titlebar color
- Notification preferences
- Test notifications