feat: hide running Cocoa receiver from the Dock

src/mpd_now_playable/receivers/cocoa/now_playing.py

@@ -1,7 +1,7 @@
 from collections.abc import Callable, Coroutine
 from typing import Literal
 
-from corefoundationasyncio import CoreFoundationEventLoop
+from AppKit import NSApplication, NSApplicationActivationPolicyAccessory
 from MediaPlayer import (
 	MPChangePlaybackPositionCommandEvent,
 	MPMusicPlaybackStatePlaying,
@@ -12,6 +12,8 @@ from MediaPlayer import (
 	MPRemoteCommandHandlerStatusSuccess,
 )
 
+from corefoundationasyncio import CoreFoundationEventLoop
+
 from ...config.model import CocoaReceiverConfig
 from ...playback import Playback
 from ...playback.state import PlaybackState
@@ -41,6 +43,9 @@ class CocoaNowPlayingReceiver(Receiver):
 		pass
 
 	async def start(self, player: Player) -> None:
+		NSApplication.sharedApplication().setActivationPolicy_(
+			NSApplicationActivationPolicyAccessory
+		)
 		self.cmd_center = MPRemoteCommandCenter.sharedCommandCenter()
 		self.info_center = MPNowPlayingInfoCenter.defaultCenter()
 

stubs/AppKit/__init__.pyi

@@ -2,32 +2,42 @@ from typing import Final, Literal
 
 from Foundation import CGSize
 
+NSApplicationActivationPolicyRegular: Final = 0
+NSApplicationActivationPolicyAccessory: Final = 1
+NSApplicationActivationPolicyProhibited: Final = 2
+NSApplicationActivationPolicy = Literal[0, 1, 2]
+
+class NSApplication:
+	@staticmethod
+	def sharedApplication() -> NSApplication: ...
+	def setActivationPolicy_(self, policy: NSApplicationActivationPolicy) -> bool: ...
+
 # There are many other operations available but we only actually use copy, so we don't need all of them here.
 NSCompositingOperationClear: Final = 0
 NSCompositingOperationCopy: Final = 1
 NSCompositingOperation = Literal[0, 1]
 
 class NSRect:
-    pass
+	pass
 
 def NSMakeRect(x: float, y: float, w: float, h: float) -> NSRect: ...
 
 class NSImage:
-    @staticmethod
-    def alloc() -> type[NSImage]: ...
-
-    @staticmethod
-    def initByReferencingFile_(file: str) -> NSImage: ...
-
-    @staticmethod
-    def initWithData_(data: bytes) -> NSImage: ...
-
-    @staticmethod
-    def initWithSize_(size: CGSize) -> NSImage: ...
-
-    def size(self) -> CGSize: ...
-
-    def lockFocus(self) -> None: ...
-    def unlockFocus(self) -> None: ...
-
-    def drawInRect_fromRect_operation_fraction_(self, inRect: NSRect, fromRect: NSRect, operation: NSCompositingOperation, fraction: float) -> None: ...
+	@staticmethod
+	def alloc() -> type[NSImage]: ...
+	@staticmethod
+	def initByReferencingFile_(file: str) -> NSImage: ...
+	@staticmethod
+	def initWithData_(data: bytes) -> NSImage: ...
+	@staticmethod
+	def initWithSize_(size: CGSize) -> NSImage: ...
+	def size(self) -> CGSize: ...
+	def lockFocus(self) -> None: ...
+	def unlockFocus(self) -> None: ...
+	def drawInRect_fromRect_operation_fraction_(
+		self,
+		inRect: NSRect,
+		fromRect: NSRect,
+		operation: NSCompositingOperation,
+		fraction: float,
+	) -> None: ...