Skip to content

Zenovs/linky

BranchesTags

Repository files navigation

🔗 Linky

Linky ist ein leichtgewichtiger Datei-Browser für macOS mit erstklassiger SMB-/NAS-Integration — und ein smb:// Protokoll-Handler für Linux und Windows.

English version below

Plattform Status Features
🍎 macOS 12+ ✅ Voll Datei-Browser, Tabs, Bonjour, Auto-Mount, Quick Actions, Tray
🐧 Linux ✅ Stabil smb:// Handler, Tray-Icon, Autostart
🪟 Windows 10/11 ✅ Stabil smb:// Handler, Clipboard-Monitor, Explorer-Kontextmenü, Tray, Auto-Update

⚡ Installation

🍎 macOS — ein Befehl

curl -fsSL https://raw.githubusercontent.com/Zenovs/linky/main/install.sh | bash

Lädt die neueste Version herunter, installiert sie in /Applications, entfernt das Quarantine-Flag und startet die App.

Bestehende Installationen aktualisieren sich automatisch: Menüleiste → „Nach Updates suchen…" oder beim nächsten Start.

🐧 Linux — ein Befehl

curl -fsSL https://raw.githubusercontent.com/Zenovs/linky/main/linux/install.sh | bash

Voraussetzungen: Python 3, pip3 (für pystray + Pillow)

Was passiert:

  • linky.py → ~/.local/bin/linky
  • Registriert smb:// via xdg-mime und gio
  • Autostart via ~/.config/autostart/
  • Tray-Icon mit Menü (GNOME, KDE, XFCE …)

Deinstallieren:

bash <(curl -fsSL https://raw.githubusercontent.com/Zenovs/linky/main/linux/uninstall.sh)

🪟 Windows — PowerShell (kein Admin nötig)

powershell -ExecutionPolicy Bypass -Command "Invoke-WebRequest https://raw.githubusercontent.com/Zenovs/linky/main/windows/install.ps1 -OutFile install.ps1; .\install.ps1"

Voraussetzungen: Python 3 (mit „Add to PATH" Haken bei der Installation)

Was passiert:

  • linky.py → %LOCALAPPDATA%\Linky\
  • Registriert smb:// Protokoll in der Windows-Registry (HKCU)
  • Kontextmenü „SMB-Link kopieren" in Explorer (Ordner, Laufwerke, Netzwerk)
  • Autostart via Registry Run-Key
  • Tray-Icon mit Auto-Update

Deinstallieren:

powershell -ExecutionPolicy Bypass -File uninstall.ps1

✨ Features

📂 Datei-Browser

  • Browser-Fenster mit Sidebar (Favoriten / NAS / Geräte) und Datei-Liste
  • Tabs — ⌘T neuer Tab, ⌘W schließen, ⌘⇧[ / ⌘⇧] wechseln; jeder Tab hat eigene Location & History
  • Navigation — Zurück/Vor (⌘[/⌘]), Aufwärts (⌘↑), klickbare Breadcrumb-Pfadleiste
  • Eigene Favoriten ★ — beliebige Ordner / Dateien zur Sidebar pinnen, persistent
  • Externe Geräte live — USB-Sticks & Festplatten erscheinen sofort beim Anschließen

🔍 Suche

  • Drei Scopes in einer Suche:
    • Aktueller Ordner (Spotlight, schnell, fokussiert)
    • Ganzer Mac (Spotlight, system-weit)
    • Alle NAS-Shares (paralleler Walker, Streaming-Ergebnisse) — Spotlight indiziert SMB nicht, Linky schon
  • Type-to-Filter wie Ubuntu — einfach im File-Bereich lostippen, Liste filtert live
  • Quick Look mit Leertaste

📡 NAS / SMB (Linky-DNA)

  • Bonjour-Discovery — SMB-Server im LAN erscheinen automatisch in der Sidebar unter „Im Netzwerk", kein „Verbinden mit Server"-Dialog mehr
  • Auto-Mount ⚡ — Verknüpfung beim App-Start und Netzwerkwechsel (Wi-Fi → Ethernet, VPN-Connect) automatisch einbinden, lautlos wenn Credentials im Schlüsselbund
  • SMB-Bookmarks — Server pinnen mit eigenem Namen, persistent über Neustarts
  • SMB-URL-Handler — smb://-Links aus Browser/Mail öffnen direkt
  • Rechtsklick im Finder → „SMB-Link kopieren" / „SMB-Link öffnen" (Quick Actions automatisch installiert)
  • Cmd+V Auto-Open — SMB-Link in Zwischenablage → wird beim Einfügen automatisch geöffnet

📁 Datei-Operationen

Aktion Shortcut
Auswählen Klick / ⌘-Klick / ⇧-Klick
Alle auswählen ⌘A
Kopieren ⌘C
Einfügen ⌘V
Verschieben ⌥⌘V
Duplizieren ⌘D
Umbenennen Kontextmenü
In Papierkorb ⌘⌫
Neuer Ordner ⇧⌘N
Information ⌘I
Vorschau Leertaste
Im Finder anzeigen Kontextmenü

🎨 Design

  • Adaptives Theme — Sage-Grün / Lavendel / Crème im Light Mode, Kupfer / Forest-Green / Charcoal im Dark Mode
  • Folgt der System-Einstellung automatisch
  • Lokalisierte Pfadleiste — Ordnernamen in System-Sprache (Schreibtisch/Desktop, Programme/Applications)
  • Transparent Title-Bar + Full-Size-Content für moderne Browser-Optik

🖥 System-Integration

  • Dock-Icon + Menüleisten-Icon parallel — App läuft auch wenn Fenster zu (Auto-Mount + Quick Actions weiter aktiv)
  • Autostart optional beim Anmelden
  • Auto-Update über GitHub Releases (täglicher Check, In-App-Install)

📸 Screenshots

Light Mode Dark Mode
Menu Bar Settings

📥 Weitere Installationsmethoden

DMG manuell herunterladen

  1. Lade die neueste Linky-vX.X.X-macOS12+.dmg herunter
  2. Öffne die DMG-Datei und ziehe Linky.app in den Programme-Ordner
  3. Falls eine Sicherheitswarnung erscheint: 
    xattr -rd com.apple.quarantine /Applications/Linky.app

Aus Quellcode bauen

Siehe BUILD.md.

🎯 Quick-Start

  1. Installieren (siehe oben)
  2. Dock-Icon klicken oder Menüleisten-🔗 → „Linky öffnen ⌘O"
  3. Browser-Fenster öffnet sich mit Sidebar
  4. NAS hinzufügen: Sidebar → „+ SMB-Server verbinden…" → Server eingeben → „Automatisch verbinden" aktivieren → fertig
  5. Suchen: Tippe in das Such-Feld, schalte Scope via Pill (Ordner / Mac / NAS)
  6. Type-to-Filter: Klick irgendwo in der Liste, fang an zu tippen → live gefiltert

💻 Systemanforderungen

macOS Linux Windows
Version macOS 12+ beliebig Windows 10/11
Speicherplatz ~5 MB ~1 MB ~1 MB
Abhängigkeiten keine Python 3, pystray, Pillow Python 3, pystray, Pillow

🐧 Linux & 🪟 Windows — Features

Gemeinsame Features (alle Plattformen)

  • smb:// Protokoll-Handler — Links aus Browser, E-Mail, Teams öffnen direkt
  • Tray-Icon mit Menü (Automatisch öffnen, Autostart, Beenden)
  • Autostart — optional beim Anmelden

🪟 Windows-spezifisch

  • Clipboard-Monitor — SMB-Link in der Zwischenablage → öffnet sich automatisch
    (entspricht Cmd+V Auto-Open auf macOS)
  • Explorer-Kontextmenü — Rechtsklick auf Netzwerkordner/Laufwerk
    → „SMB-Link kopieren" → \\server\share\pfad → smb://server/share/pfad in Ablage
    (entspricht Finder Quick Actions auf macOS)
  • Auto-Update — täglicher Check auf GitHub Releases, Dialog bei neuer Version
  • Gemappte Laufwerke — Z:\Ordner wird automatisch per WNetGetUniversalNameW aufgelöst

🔧 Berechtigungen

  • Bedienungshilfen — Erkennen von Cmd+V
  • Mitteilungen — Status-Benachrichtigungen
  • AppleEvents — Öffnen von SMB-Freigaben im Finder
  • Lokales Netzwerk — Bonjour-Discovery (wird beim ersten Browse abgefragt)

📝 Changelog

Siehe CHANGELOG.md.

📄 Lizenz

MIT License — Siehe LICENSE.

🔗 Linky (English)

Linky is a lightweight file browser for macOS with first-class SMB / NAS integration — and an smb:// protocol handler for Linux and Windows.

Platform Status Features
🍎 macOS 12+ ✅ Full File browser, tabs, Bonjour, auto-mount, Quick Actions, tray
🐧 Linux ✅ Stable smb:// handler, tray icon, autostart
🪟 Windows 10/11 ✅ Stable smb:// handler, clipboard monitor, Explorer context menu, tray, auto-update

⚡ Install

🍎 macOS — one command

curl -fsSL https://raw.githubusercontent.com/Zenovs/linky/main/install.sh | bash

Downloads the latest release, installs to /Applications, removes the quarantine flag, and launches the app.

Existing installs auto-update: menu bar → "Check for Updates…" or on next launch.

🐧 Linux — one command

curl -fsSL https://raw.githubusercontent.com/Zenovs/linky/main/linux/install.sh | bash

Requirements: Python 3, pip3 (for pystray + Pillow)

Uninstall:

bash <(curl -fsSL https://raw.githubusercontent.com/Zenovs/linky/main/linux/uninstall.sh)

🪟 Windows — PowerShell (no admin required)

powershell -ExecutionPolicy Bypass -Command "Invoke-WebRequest https://raw.githubusercontent.com/Zenovs/linky/main/windows/install.ps1 -OutFile install.ps1; .\install.ps1"

Requirements: Python 3 (check "Add to PATH" during installation)

What happens:

  • linky.py → %LOCALAPPDATA%\Linky\
  • Registers smb:// protocol in Windows Registry (HKCU — no admin needed)
  • Context menu "Copy SMB link" in Explorer (folders, drives, network shares)
  • Autostart via Registry Run key
  • Tray icon with auto-update

Uninstall:

powershell -ExecutionPolicy Bypass -File uninstall.ps1

✨ Features

📂 File browser

  • Browser window with sidebar (Favorites / NAS / Devices) and file list
  • Tabs — ⌘T new tab, ⌘W close, ⌘⇧[ / ⌘⇧] switch; each tab has its own location & history
  • Navigation — back/forward (⌘[/⌘]), up (⌘↑), clickable breadcrumb path bar
  • Custom favorites ★ — pin any folder/file to the sidebar, persistent
  • External devices live — USB sticks & drives appear instantly on plug-in

🔍 Search

  • Three scopes in one search:
    • Current folder (Spotlight, fast, focused)
    • Whole Mac (Spotlight, system-wide)
    • All NAS shares (parallel walker, streaming results) — Spotlight doesn't index SMB, Linky does
  • Type-to-filter (Ubuntu-style) — just start typing while the list is focused, live-filtered view
  • Quick Look with spacebar

📡 NAS / SMB (Linky's DNA)

  • Bonjour discovery — SMB servers on your LAN appear automatically in the sidebar under "On the network", no "Connect to Server" dialog needed
  • Auto-mount ⚡ — bookmarked shares reconnect on app launch and network change (Wi-Fi → Ethernet, VPN connect), silently when credentials are in Keychain
  • SMB bookmarks — pin servers with a custom name, persistent across restarts
  • SMB URL handler — smb:// links from browser/mail open directly
  • Right-click in Finder → "Copy SMB link" / "Open SMB link" (Quick Actions installed automatically)
  • Cmd+V auto-open — SMB link in clipboard → opens automatically on paste

📁 File operations

Action Shortcut
Select Click / ⌘-click / ⇧-click
Select all ⌘A
Copy ⌘C
Paste ⌘V
Move ⌥⌘V
Duplicate ⌘D
Rename Context menu
Move to trash ⌘⌫
New folder ⇧⌘N
Get info ⌘I
Preview Spacebar
Show in Finder Context menu

🎨 Design

  • Adaptive theme — sage / lavender / cream in light mode, copper / forest-green / charcoal in dark mode
  • Follows system appearance automatically
  • Localized path bar — folder names in system language (Desktop/Schreibtisch, Applications/Programme)
  • Transparent title bar + full-size content for modern browser look

🖥 System integration

  • Dock icon + menu bar icon in parallel — app keeps running when window is closed (auto-mount + Quick Actions stay active)
  • Autostart optional at login
  • Auto-update via GitHub Releases (daily check, in-app install)

📥 Other installation methods

Download DMG manually

  1. Download the latest Linky-vX.X.X-macOS12+.dmg
  2. Open the DMG and drag Linky.app to Applications
  3. If a security warning appears: 
    xattr -rd com.apple.quarantine /Applications/Linky.app

Build from source

See BUILD.md.

💻 System requirements

macOS Linux Windows
Version macOS 12+ any Windows 10/11
Disk space ~5 MB ~1 MB ~1 MB
Dependencies none Python 3, pystray, Pillow Python 3, pystray, Pillow

🪟 Windows features

  • Clipboard monitor — SMB link in clipboard → opens automatically (like Cmd+V auto-open on macOS)
  • Explorer context menu → "Copy SMB link" — converts \\server\share\path to smb://server/share/path (like Finder Quick Actions on macOS)
  • Auto-update — daily check against GitHub Releases
  • Mapped drives — Z:\folder resolved automatically via WNetGetUniversalNameW

🔧 Permissions

  • Accessibility — detect Cmd+V
  • Notifications — status notifications
  • AppleEvents — open SMB shares in Finder
  • Local network — Bonjour discovery (asked on first browse)

📝 Changelog

See CHANGELOG.md.

📄 License

MIT License — See LICENSE.

About

SMB Link Manager für Mac

Resources

Readme

License

MIT license

Contributing

Contributing
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases 8

v3.0.2 — NAS-Suche findet wieder Latest
May 26, 2026
+ 7 releases

Packages

 
 
 

Contributors

Languages