All Projects → iSapozhnik → Popover

iSapozhnik / Popover

Licence: MIT License
Custom macOS Popover 💬

Programming Languages

swift
15916 projects

Projects that are alternatives of or similar to Popover

Chinese Lunar Calendar For Mac
Chinese Lunar Calendar for Mac
Stars: ✭ 150 (+111.27%)
Mutual labels:  menubar, statusbar, osx
osx-statusbar-countdown
⏳📅 A utility to count down to a date from your macOS menubar, written in Swift
Stars: ✭ 40 (-43.66%)
Mutual labels:  menubar, statusbar, osx
Menubar Brightness
MacOS app to change the screen brightness on the menubar.
Stars: ✭ 77 (+8.45%)
Mutual labels:  menubar, osx
Cumulus
☁️ A SoundCloud player that lives in your menubar.
Stars: ✭ 1,287 (+1712.68%)
Mutual labels:  menubar, osx
Electron Menubar
Boilerplate for electron menubar application with PopOver with React + Webpack
Stars: ✭ 145 (+104.23%)
Mutual labels:  menubar, popover
Amm
Aria2 Menubar Monitor
Stars: ✭ 312 (+339.44%)
Mutual labels:  menubar, osx
Jmcs
Java framework to homogenize your GUI across all the 3 main desktop OS, and further integrates your app to them.
Stars: ✭ 5 (-92.96%)
Mutual labels:  menubar, statusbar
barbar
DEPRECATED — OSX crypto-currency price ticker
Stars: ✭ 55 (-22.54%)
Mutual labels:  statusbar, osx
Yubiswitch
OSX status bar application to enable/disable Yubikey Nano
Stars: ✭ 653 (+819.72%)
Mutual labels:  statusbar, osx
Lyricsx
🎶 Ultimate lyrics app for macOS.
Stars: ✭ 3,251 (+4478.87%)
Mutual labels:  menubar, macos-app
Pibar
PiBar for Pi-hole - Manage your Pi-hole(s) from your menu bar!
Stars: ✭ 208 (+192.96%)
Mutual labels:  menubar, osx
Ambar-Xamarin
A macOS Menu Bar app built with Xamarin and C#
Stars: ✭ 63 (-11.27%)
Mutual labels:  popover, macos-app
Ccnstatusitem
CCNStatusItem is a subclass of NSObject to act as a custom view for NSStatusItem. It supports a customizable statusItemWindow handling any viewController for presenting the content.
Stars: ✭ 223 (+214.08%)
Mutual labels:  statusbar, popover
Airpodsbattery Monitor For Mac
Simple Widget to display your AirPods battery levels from the Mac Status bar
Stars: ✭ 165 (+132.39%)
Mutual labels:  statusbar, osx
Osx Mac Menubar App
Menubar application for Mac
Stars: ✭ 11 (-84.51%)
Mutual labels:  menubar, osx
Gitee
Gitee, OS X status bar application for Github
Stars: ✭ 1,095 (+1442.25%)
Mutual labels:  statusbar, osx
Trayplay
An app for macOS that lives in your menu bar and lets you easily control iTunes or Spotify, without interrupting your workflow.
Stars: ✭ 137 (+92.96%)
Mutual labels:  menubar, osx
Sloth
Mac app that shows all open files, directories, sockets, pipes and devices in use by all running processes. Nice GUI for lsof.
Stars: ✭ 4,549 (+6307.04%)
Mutual labels:  osx, macos-app
Dogetv macos
🎬 dogeTV for macOS
Stars: ✭ 92 (+29.58%)
Mutual labels:  osx, macos-app
Quickeys
A mac menu bar app that provides note taking functionality though a quick dropdown menu.
Stars: ✭ 54 (-23.94%)
Mutual labels:  menubar, statusbar

Popover

Swift macOS License: MIT

Custom macOS popover.

alt text

Install

Since this is a Swift Package, the installation process is pretty stright forward.

Manual way

Update your Package.swift dependencies:

dependencies: [
    .package(url: "https://github.com/iSapozhnik/Popover", from: "1.1.1")
]

Via Xcode:

  1. Go to File -> Swift Packages -> Add Package Dependency.
  2. Put GitHub URL https://github.com/iSapozhnik/Popover and click Next
  3. Select the latest version
  4. Click Finish

How to use

  1. In your AppDelegate import Popover
  2. Create a view you want to put into a status bar.
  3. Create a content view controller which would be embedded inside Popover
  4. Optionally create menu items
  5. Create a Popover instance. Here you can use either standard configuration (you don't need to pass windowConfiguration parameter in this case) or you can subclass DefaultConfiguration, override some properties and pass a new instance as a parameter. If in step 4 you have created menu items, pass it here as well. You can see them by making right click on menu bar item.
  6. Call prepare to set everything up.

And here is how typical AppDelegate may look like:

import Cocoa
import Popover

class MyPopoverConfiguration: DefaultConfiguration {
    override var backgroundColor: NSColor {
        return NSColor.systemRed
    }

    override var borderColor: NSColor? {
        return NSColor.red
    }
}

@NSApplicationMain
class AppDelegate: NSObject, NSApplicationDelegate {
    var popover: Popover!

    func applicationDidFinishLaunching(_ aNotification: Notification) {
        let statusItemView = StatusItemView(frame: NSRect(width: 22.0, height: 20))

        let viewController = MainViewController()

        let menuItems: [Popover.MenuItemType] = [
            .item(Popover.MenuItem(title: "Settings", action: viewController.showSettings)),
            .separator,
            .item(Popover.MenuItem(title: "Quit", key: "q", action: viewController.quit))
        ]

        popover = Popover(with: MyPopoverConfiguration(), menuItems: menuItems)
        popover.prepare(with: statusItemView, contentViewController: viewController)
    }
}

What can be customized?

Quite a lot of things:

public protocol PopoverConfiguration {
    /// The distance from Popover's arrow to a status item.
    var popoverToStatusItemMargin:  CGFloat { get }

    /// Popover's background color.
    var backgroundColor:            NSColor { get }

    /// Popover's border color.
    /// - Important:
    ///     If `borderColor` returns `nil`, settings `borderWidth` won't make any effect. See also: `borderWidth`.
    var borderColor:                NSColor? { get }

    /// Popover's border width.
    /// - Important:
    ///      If Popover's border color is set to `nil`, setting `borderWidth` won't make any effect.
    var borderWidth:                CGFloat { get }

    /// Defines Popover arrow height.
    var arrowHeight:                CGFloat { get }

    /// Defines Popover arrow width.
    var arrowWidth:                 CGFloat { get }

    /// Defines Popover corner radius.
    /// - Warning:
    ///     If this value is too big and if the Popover's status item (menu bar view) is too close to the right edge, the appearence of the Popover might be odd.
    var cornerRadius:               CGFloat { get }

    /// Defines Popover content edge insets.
    var contentEdgeInsets:          NSEdgeInsets { get }

    /// The distance from the right side of the Popover to the screen's edge.
    /// - Warning:
    ///     If this value is too big and if the Popover's status item (menu bar view) is too close to the right edge, the appearence of the Popover might be odd.
    var rightEdgeMargin:            CGFloat { get }
}

Mentions

Credits

Created and maintained by @iSapozhnik.

License

Released under the MIT License. See LICENSE for details.

Copyright © 2020-present Sapozhnik Ivan.

Heavily inspired by CCNStatusItem

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].