Warning
OpenLogi hâlâ aktif geliştirme aşamasında ve henüz kararlı değil — özellikler ve ayarlar değişebilir. Yeni bir sürüm çıktığında haberdar olmak için depoya Star ⭐ verin ve Watch 👀 edin.
⚡️ Rust 🦀 ile yazılmış, Logitech Options+'a yerel ve tamamen çevrimdışı çalışan bir alternatif
Logitech fare, klavye ve web kameralarının tüm gücünü HID++ ve UVC üzerinden açığa çıkarır
Options+'tan bıktınız mı? OpenLogi'yi deneyin.
macOS, Linux ve Windows'ta çalışır.
OpenLogi'nin Options+'ta bulamayacağınız özellikleri:
- Hafif kalır. Native Rust + GPUI.
- Linux'ta çalışır. Linux, OpenLogi'de birinci sınıf bir platformdur.
- Desteklenen tuşlarda jestler. Desteklenen kontrollere jest eylemleri atayın — isterseniz jestleri tamamen kapatın.
- Düz metin ayar dosyası. Her şey tek bir TOML dosyasında; makineler arasında istediğiniz şekilde senkronize edin.
- Betiklenebilir. Arayüzün yanında gerçek bir CLI; DPI, imleç ölçekleme ve SmartShift için donanım tanılama araçlarıyla birlikte.
- Logi Bolt alıcıları, Unifying alıcıları, Bluetooth veya kablolu bağlantı üzerinden tanınan cihazlar; pil yüzdesi ve şarj durumu dahil
- İşletim sistemi giriş kancası üzerinden tuş yeniden atama: hazır eylem kataloğu ve TOML ayar dosyasında tanımlanan özel klavye kısayolları, bağımsız kısa/uzun basış eylemleri ve bas-konuş için basılı tutma kombinasyonları¹ dahil
- Uygulama odaklandığında otomatik geçiş yapan uygulama başına profil katmanları (macOS + Windows; Linux'ta sadece X11 / XWayland)
- Litra ışıkları: güç, parlaklık ve renk sıcaklığı; kamera etkinliğini takip eden isteğe bağlı otomatik güç özelliğiyle
Fare
- Orta tuş, mod değiştirme ve parmak tekerleği tuşlarını yakalayıp yeniden atama (orta tuş her yerde, diğerleri cihazın desteklediği yerlerde)
- Desteklenen tuşlarda canlı yakalamalı, yöne göre jest atamaları: Geri/İleri, DPI/ModeShift, özel jest tuşu ve dokunsal panel
- DPI/ModeShift jestleri, cihazın yönlendirme (diversion) ve ham XY desteği bildirmesini gerektirir.
- Birincil tıklamalara ve tekerlek kontrollerine yeni jest ataması yapılamaz; mevcut Orta Tık jest atamaları korunur.
- Actions Ring: imleç merkezli, sekiz yuvalı eylem overlay'i (
ShowActionsRing), uygulama başına düzenlerle - Önayarlı DPI kontrolü ve Döngü / Önayar-Belirle eylemleri (
0x2201) - SmartShift tekerleği: mod geçişi, hassasiyet ve kalıcı mandal (ratchet) paneli (
0x2111) - Cihaza özel yerel kaydırma yönü ters çevirme (
0x2121, desteklenen cihazlarda)
Klavye
- Genel F-tuşu yeniden atama: farenin kullandığı aynı eylem kataloğu, ayrıca ileri düzey kullanıcı eylemleri — yazılı metin, tuş kombinasyonları, çok adımlı iş akışları (macOS + Windows)
- Statik RGB aydınlatma (
0x8070/0x8080, desteklenen cihazlarda)
Kamera
- Herhangi bir Logitech UVC web kamerası (Brio, StreamCam, C920 serisi vb.), tak-çalıştır
- Sadece izlediğiniz sürece kamerayı açan canlı önizleme — pencereyi kapattığınızda kamera tamamen serbest kalır ve LED söner
- Doğrudan UVC donanımına yazılan görüntü kontrolleri — yakınlaştırma, kaydırma, eğme, odak, pozlama, parlaklık, kontrast, doygunluk, netlik, kazanç, arka ışık dengelemesi, beyaz dengesi, ton, flicker önleme ve düşük ışık dengelemesi; odak / pozlama / beyaz dengesi için otomatik mod anahtarlarıyla — değişiklikler Meet / Zoom / OBS ve kamerayı kullanan tüm diğer uygulamalarda hemen uygulanır
- Tek tıkla profiller: yerleşik Varsayılan / Yayın / Görüntülü arama profilleri ile özel anlık görüntüler; ayarlar kamera başına saklanır ve bir sonraki görüntülemede donanıma geri yazılır
¹ Medya tuşu eylemleri Linux'ta D-Bus MPRIS kullanır; bazı macOS'a özel eylemlerin Linux'ta evrensel bir karşılığı yoktur ve bu platformda hiçbir şey yapmaz. Windows, platform eylemlerini mevcut olduğunda yerel karşılıklarına eşler.
Important
Önce Logi Options+'tan çıkın: iki uygulama da HID++ erişimi için rekabet eder ve bir alıcıyı aynı anda yalnızca biri kullanabilir.
macOS 13 veya üzeri gerektirir.
İmzalı ve notarize edilmiş .dmg dosyasını son sürümden indirip OpenLogi.app'i /Applications'a sürükleyin.
Veya Homebrew ile kurun:
brew install --cask openlogiResmi Homebrew cask'i varsayılan kurulum yoludur. aprilnea/tap'ten en son
GitHub sürümünü doğrudan takip etmek isterseniz:
brew tap aprilnea/tap
brew install --cask aprilnea/tap/openlogi@latestopenlogi@latest, OpenLogi'nin release iş akışı tarafından yönetilir ve
resmi cask'in otomatik güncellemesinden önce güncellenebilir. openlogi
veya openlogi@latest'ten yalnızca birini kurun, ikisini birden değil.
Kurulum betiğini HTTPS üzerinden indirin, inceleyin, sonra çalıştırın. Doğrudan bir kabuğa (shell) pipe'lamayın:
curl --proto '=https' --proto-redir '=https' --tlsv1.2 \
--fail --location --silent --show-error \
--retry 3 --retry-connrefused \
--output openlogi-install.sh \
https://raw.githubusercontent.com/AprilNEA/OpenLogi/master/packaging/linux/install.sh
less openlogi-install.sh
sh openlogi-install.sh
rm openlogi-install.shBetik; apt, dnf, yum, zypper, rpm veya pacman'ı tespit eder, makineye uygun
.deb, .rpm ya da .pkg.tar.zst dosyasını seçer, OpenLogi'nin gömülü
minisign açık anahtarıyla ayrık imzayı doğrular ve paket yöneticisini
sudo ile çağırmadan önce dosyanın release SHA256SUMS listesindeki
girdiyle eşleştiğini kontrol eder. Önce dağıtımınızın paket yöneticisinden
minisign'ı kurun. Betiği normal kullanıcınızla çalıştırın, sudo ile değil.
Varsayılan olarak en son sürümü kurar. Gerektiğinde --version,
--package-manager, --no-start veya --dry-run seçeneklerini kullanın.
Paketler hem x86_64/amd64 hem de arm64/aarch64 için yayınlanır.
Hazır paketler GLIBC 2.35 veya daha yenisini gerektirir (Ubuntu 22.04 tabanı).
NixOS kullanıcıları, paketi ve udev kurallarını kuran ve grafik oturumuyla birlikte ajanı başlatan deponun modülünü doğrudan içe aktarabilir:
{
inputs.nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
inputs.openlogi = {
url = "github:AprilNEA/OpenLogi";
inputs.nixpkgs.follows = "nixpkgs";
};
outputs = { nixpkgs, openlogi, ... }: {
nixosConfigurations.my-host = nixpkgs.lib.nixosSystem {
system = "x86_64-linux"; # veya aarch64-linux
modules = [
openlogi.nixosModules.default
{ programs.openlogi.enable = true; }
];
};
};
}Tüm Linux paketleri, kullanıcınıza sudo gerekmeden /dev/hidraw*,
/dev/uinput ve Logitech farenizin /dev/input/event* düğümüne erişim
veren udev kuralları kurar. Kurulum betiği ve NixOS modülü ajanı otomatik
başlatır; elle paket kurulumundan sonra kendi kullanıcınız için etkinleştirin:
systemctl --user enable --now openlogi-agent.serviceSabit sürüm kurulumları, eksiksiz NixOS seçenekleri, kaynaktan kurulum ve systemd olmayan dağıtımlar için docs/INSTALL-linux.md'ye bakın.
İmzalı taşınabilir .zip arşivleri ve kullanıcı başına .msi kurulum
dosyaları (x86_64 ve arm64) her sürüme eklenir. Her ikisi de arayüzü
(OpenLogi.exe) tüm cihaz G/Ç'sini üstlenen arka plan ajanıyla
(openlogi-agent.exe) birlikte içerir. Taşınabilir zip'i kullanırken iki
dosyayı aynı klasörde tutun, aksi halde arayüzün bağlanacağı bir şey olmaz.
Windows desteği, gerçek donanımla (kablolu bir klavye ve Unifying alıcılı
bir fare) Windows 11'de kurulum, yerinde güncelleme ve MSI kaldırma dahil
uçtan uca doğrulanmıştır. macOS yapısından daha yenidir; sorunla
karşılaşırsanız lütfen bildirin.
Ajan, ana pencere kapatıldıktan sonra uygulamaya erişimi sürdürmek için
sistem tepsisinde bir simge gösterir (Ana Pencereyi Göster / Çıkış).
Windows'ta bunu kapatmak için TOML dosyasındaki [app_settings] bloğunda
show_in_menu_bar = false ayarlayıp ajanı yeniden başlatın; arayüz anahtarı
şu an için yalnızca macOS'ta mevcuttur.
Kaynaktan derlemek için DEVELOPMENT.md'ye bakın.
USAGE.md'ye bakın
Ayarlar düz TOML kullanır; kaydetme işlemleri sembolik bağlı (symlink) ayar dosyalarını korur. CONFIGURATION.md'ye bakın.
DEVELOPMENT.md'ye bakın, macOS giriş-kancası güvenliği dahil.
- Windows, kameralar ve i18n: @davidbudnick — klavye RGB, Windows desteği, Logitech web kamerası desteği
- Linux portu: @cserby — Linux desteği
- Solaar (@pwr) — açık kaynak HID++ uygulaması
- Mouser (@TomBadash) — hesap gerektirmeyen, yerel bir Options+ alternatifi
Bu depodaki kod, aşağıdakilerden birinin seçimine bağlı olarak çift lisanslıdır:
- Apache License, Version 2.0 (LICENSE-APACHE)
- MIT lisansı (LICENSE-MIT)
crates/openlogi-hidpp, @lus tarafından yazılan
hidpp paketinin 0BSD lisanslı, depoya
gömülü bir çatallanmasıdır (fork).
OpenLogi logosunu tasarlayan @kubai087'e
teşekkürler. OpenLogi logosu ve uygulama simgesi (design/
altındaki marka varlıkları) © 2026 AprilNEA'ya aittir, tüm hakları saklıdır,
ve yukarıdaki MIT/Apache lisansları kapsamında değildir; bakınız
design/LICENSE. Kodu çatallamak, OpenLogi adı, logosu
veya simgesi üzerinde hak vermez; lütfen bunları kendi projelerinizi,
çatallarınızı veya dağıtımlarınızı temsil etmek için önceden yazılı izin
almadan kullanmayın.
Logitech ile bağlantılı değildir. "Logitech", "MX Master" ve "Options+", Logitech International S.A.'nın ticari markalarıdır.