sway Documentation

I3-compatible Wayland compositor

17,141 stars C C 1 file · ~12,325 tokens #compositor#wayland
RAW Doc

Docker & Self-Hosted Deployment Verified OCI

Deploy sway on any server, homelab, or cloud container platform.

1-Click Terminal Command
bash (docker run)
docker run -d --name sway --restart always fuellabs/sway:latest

File: README.md

sway

English - عربي - Azərbaycanca - Česky - Deutsch - Dansk - Español - Français - ქართული - Ελληνικά - हिन्दी - Magyar - فارسی - Italiano - 日本語 - 한국어 - Nederlands - Norsk - Polski - Português - Română - Русский - Српски - Svenska - Türkçe - Українська - 中文-简体 - 中文-繁體

sway is an i3-compatible Wayland compositor. Read the FAQ. Join the
IRC channel (#sway on irc.libera.chat).

Release Signatures

Releases are signed with E88F5E48 and published on GitHub.

Installation

From Packages

Sway is available in many distributions. Try installing the "sway" package for
yours.

Compiling from Source

Check out this wiki page if you want to build the HEAD of
sway and wlroots for testing or development.

Install dependencies:

  • meson *
  • wlroots
  • wayland
  • wayland-protocols *
  • pcre2
  • json-c
  • pango
  • cairo
  • gdk-pixbuf2 (optional: additional image formats for system tray)
  • swaybg (optional: wallpaper)
  • scdoc (optional: man pages) *
  • git (optional: version info) *

* Compile-time dep

Run these commands:

text
meson setup build/
ninja -C build/
sudo ninja -C build/ install

Configuration

If you already use i3, then copy your i3 config to ~/.config/sway/config and
it'll work out of the box. Otherwise, copy the sample configuration file to
~/.config/sway/config. It is usually located at /etc/sway/config.
Run man 5 sway for information on the configuration.

Running

Run sway from a TTY or from a display manager.


File: README.ar.md

sway

sway

هو مدير للمجموعات المركبة لـWayland متوافق مع i3 -

إقرأ الأسئلة الشائعة

انضم الى قناة IRC

تواقيع الإصدار

تٌوقع الإصدارات بـواسطة E88F5E48 و تُنشر على GitHub

التثبيت

بإستخدام الحزم

يتوفر Sway للعديد من التوزيعات، حاول تثبيت حزمة "sway" لتوزيعتك

التجميع من المصدر

إطلع على صفحة الويكي هذه إذا أردت بناء الـHEAD من sway و wlroots لأغراض الفحص والتطوير

تثبيت اللوازم:

  • meson *
  • wlroots
  • wayland
  • wayland-protocols *
  • pcre2
  • json-c
  • pango
  • cairo
  • gdk-pixbuf2 (optional: system tray)
  • scdoc (optional: man pages) *
  • git (optional: version info) *

* Compile-time dep

نفذ هذه الأوامر:

text
meson setup build/
ninja -C build/
sudo ninja -C build/ install

الإعدادات

إذا كنت بالفعل تستخدم i3، فعليك نسخ إعدادات i3 لديك إلى ~/.config/sway/config وسوف تعمل تلقائياً.

و إلا عليك نسخ ملف الإعدادات النموذج إلى config/sway/config الموجود عادةً في /etc/sway/config.

التشغيل

شغل sway بإستخدام أمر TTY.
قد يعمل بعض مدراء العرض مع أنهم غير مدعومون من sway
(gdm مثلاً يعمل بشكل جيد إلى حد ما)


File: README.cs.md

sway

sway je waylandový kompozitor kompatibilní s i3. Přečtěte si
FAQ (anglicky). Připojte se na IRC kanál (anglicky)
(#sway na irc.libera.chat).

Podpisy vydání

Vydané verze jsou podepsány klíčem E88F5E48 a publikovány
na GitHubu.

Instalace

Z balíků

Sway je dostupný v mnoha distribucích. Zkuste v té vaší nainstalovat balík "sway".

Kompilace ze zdrojových kódů

Pokud chcete sestavit HEAD repozitáře sway a wlroots pro testování nebo vývoj,
použijte návod na této stránce na wiki (anglicky).

Nainstalujte závislosti:

  • meson *
  • wlroots
  • wayland
  • wayland-protocols *
  • pcre2
  • json-c
  • pango
  • cairo
  • gdk-pixbuf2 (volitelné: dodatečné formáty ikon pro oznamovací oblast)
  • swaybg (volitelné: tapeta plochy)
  • scdoc (volitelné: man stránky) *
  • git (volitelné: informace o verzi) *

* Závislost pouze pro kompilaci

Spusťte tyto příkazy:

text
meson setup build/
ninja -C build/
sudo ninja -C build/ install

Konfigurace

Pokud již používáte i3, zkopírujte svou konfiguraci i3 do ~/.config/sway/config
a ta bude ihned fungovat. Jinak zkopírujte do ~/.config/sway/config ukázkový
konfigurační soubor. Ten se obvykle nachází v /etc/sway/config.
Pro více informací o konfiguraci spusťte man 5 sway.

Spuštění

Spusťte sway z TTY nebo ze správce displeje.


File: README.de.md

Sway

Sway ist ein i3-kompatibler Wayland-Compositor. Lies die FAQ. Tritt dem IRC Channel bei (#sway on irc.libera.chat; Englisch).

Signaturen

Jeder Release wird mit dem PGP-Schlüssel E88F5E48 signiert und auf GitHub veröffentlicht.

Installation

Über die Paketverwaltung

Sway kann in vielen Distributionen direkt durch die Paketverwaltung installiert werden. Versuche einfach das Paket "sway" zu installieren.

Quellcode selbst kompilieren

sway benötigt die folgenden Pakete:

  • meson *
  • wlroots
  • wayland
  • wayland-protocols*
  • pcre2
  • json-c
  • pango
  • cairo
  • gdk-pixbuf2 (Optional, wird für das Benachrichtigungsfeld (System Tray) benötigt)
  • swaybg (Optional, wird für das Setzen von Desktophintergrundbildern benötigt)
  • scdoc (Optional, wird für die Dokumentation (Man Pages) benötigt)*
  • git (Optional: Versionsinfo)*

*Werden nur für das Kompilieren benötigt

Führe die folgenden Befehle aus:

text
meson setup build/
ninja -C build/
sudo ninja -C build/ install

Schaue in das Wiki (Englisch) für Informationen, falls du zum Testen oder Entwickeln den neuesten Stand (HEAD) von sway und wlroots kompilieren willst.

Konfiguration

Falls du von i3 migrierst, kannst du deine Konfigurationsdatei nach ~/.config/sway/config kopieren und die Einstellungen sollten ohne Weiteres funktionieren. Ansonsten kannst du die Beispielkonfiguration, die normalerweise in /etc/sway/config liegt, nach ~/.config/sway/config kopieren. Die Dokumentation zur Konfigurationsdatei findest du in man 5 sway.

Sway starten

Sway kann einfach mit dem Befehl sway vom TTY oder mithilfe eines Displaymanagers gestartet werden.


File: README.dk.md

Sway

Sway er en i3-kompatibel Wayland compositor. Læs Ofte stillede spørgsmål.
Deltag på IRC kanalen (#sway på irc.libera.chat).

Udgivelses Signaturer

Udgivelser er signeret med E88F5E48 og publiceret på GitHub.

Installation

Fra pakker

Sway er tilgængelig i mange distributioner. Prøv at installere "sway" pakken
fra din.

Hvis du er interesseret i at pakke Sway til din distribution, kan du tage forbi
IRC kanalen eller sende en email til [email protected] for rådgivning.

Kompilering fra kildekode

Se denne wiki-side hvis du vil bygge HEAD af sway og
wlroots til test eller udvikling.

Installationsafhængigheder:

  • meson *
  • wlroots
  • wayland
  • wayland-protocols *
  • pcre2
  • json-c
  • pango
  • cairo
  • gdk-pixbuf2 (valgfrit: system tray)
  • scdoc (valgfrit: man pages) *
  • git *

*Kompileringsafhængighed

Kør følgende kommandoer:

text
meson setup build
ninja -C build
sudo ninja -C build install

Konfiguration

Hvis du allerede bruger i3 kan du bare kopiere din i3 konfiguration til
~/.config/sway/config. Ellers skal du kopiere eksempelkonfigurationsfilen til
~/.config/sway/config. Den er normalt placeret i /etc/sway/config. Kør
man 5 sway for at få oplysninger om konfigurationen.

Eksekvering

Kør sway fra en TTY eller fra en display manager.


File: README.es.md

sway

sway es un compositor de Wayland compatible con i3.
Lea el FAQ. Únase al canal de IRC (#sway on
irc.libera.chat).

Firmas de las versiones

Las distintas versiones están firmadas con E88F5E48
y publicadas en GitHub.

Instalación

Usando paquetes

Sway está disponible en muchas distribuciones. Pruebe instalando el paquete "sway" desde la suya.
Si no está disponible, puede consultar esta documentación
y así obtener información acerca de como instalarlo.

Si está interesado en crear un paquete para su distribución, únase al canal de IRC o
escriba un email a [email protected]

Compilando el código fuente

Instale las dependencias:

  • meson *
  • wlroots
  • wayland
  • wayland-protocols *
  • pcre2
  • json-c
  • pango
  • cairo
  • gdk-pixbuf2 (optional: system tray)
  • scdoc (optional: man pages) *
  • git *

*Compile-time dep

Desde su consola, ejecute las órdenes:

text
meson setup build
ninja -C build
sudo ninja -C build install

Configuración

Si ya utiliza i3, copie su archivo de configuración de i3 a ~/.config/sway/config y
sway funcionará sin tener que configurar nada más. En otro caso, copie el archivo de
configuración básico a ~/.config/sway/config, normalmente se encuentra en /etc/sway/config.
Ejecute man 5 sway para obtener información sobre la configuración.

Ejecución

Ejecute sway desde su consola. Algunos gestores de pantalla pueden funcionar sin estar
soportados por sway (sabemos que gdm funciona bastante bien).


File: README.fr.md

sway

Sway est un compositeur Wayland compatible avec i3. Lisez la
FAQ. Rejoignez le canal IRC (#sway sur irc.libera.chat).

Aide en français

abdelq fournit du support en français sur IRC et Github, dans le fuseau
horaire UTC-4 (EST).

Signatures de nouvelles versions

Les nouvelles versions sont signées avec E88F5E48 et publiées
sur GitHub.

Installation

À partir de paquets

Sway est disponible sur beaucoup de distributions. Essayez d'installer le
paquet "sway" pour la vôtre.

Si vous êtes intéressé à maintenir Sway pour votre distribution, passez sur le
canal IRC ou envoyez un e-mail à [email protected] (en anglais seulement) pour des
conseils.

Compilation depuis les sources

Consultez cette page wiki si vous souhaitez
compiler la révision HEAD de sway et wlroots pour tester ou développer.

Installez les dépendances :

  • meson *
  • wlroots
  • wayland
  • wayland-protocols *
  • pcre2
  • json-c
  • pango
  • cairo
  • gdk-pixbuf2 (optionnel : system tray)
  • scdoc (optionnel : requis pour les pages man) *
  • git (optionnel : information de version) *

* Requis uniquement pour la compilation

Exécutez ces commandes :

text
meson setup build
ninja -C build
sudo ninja -C build install

Configuration

Si vous utilisez déjà i3, copiez votre configuration i3 vers
~/.config/sway/config et sway fonctionnera directement. Sinon, copiez
l'exemple de fichier de configuration vers ~/.config/sway/config. Il se
trouve généralement dans /etc/sway/config. Exécutez man 5 sway pour lire la
documentation sur la configuration de sway.

Exécution

Exécutez sway à partir d'un TTY ou d'un gestionnaires d'affichage.


File: README.ge.md

sway

sway არის i3-თავსებადი Wayland-ის კომპოზიტორი. მეტი ინფორმაციისთვის იხილეთ
FAQ. დაუკავშირდით IRC არხს (#sway irc.libera.chat-ზე).

გამოშვების ხელმოწერები

გამოშვებები ხელმოწერილია E88F5E48-ით და გამოქვეყნებულია GitHub-ზე.

ინსტალაცია

რეპოზიტორიიდან

Sway არის ხელმისაწვდომი ბევრი დისტრიბუტაციისთვის. ცადეთ "sway" პაკეტის ინსტალაცია თქვენთვის.

კოდის კომპილაცია

იხილეთ ეს ვიკი გვერდი თუ გინდათ რომ ააწყოთ sway და wlroots სატესტოდ ან დეველოპმენტისთვის.

დააინსტალირეთ დამოკიდებულებები:

  • meson *
  • wlroots
  • wayland
  • wayland-protocols *
  • pcre2
  • json-c
  • pango
  • cairo
  • gdk-pixbuf2 (ასევე არჩევითია: system tray)
  • scdoc (ასევე არჩევითია: man pages) *
  • git (ასევე არჩევითია: version info) *

* Compile-time dep

გაუშვით ეს ბრძანებები:

text
meson setup build/
ninja -C build/
sudo ninja -C build/ install

კონფიგურაცია

თუ უკვე იყენებთ i3-ს, მაშინ დააკოპირე i3 კონფიგურაცია და ჩასვი ~/.config/sway/config
და უპრობლემოდ იმუშავებს პირდაპირ. წინააღმდეგ შემთხვევაში კონფიგურაციის ნიმუში ჩააკოპირეთ აქ: ~/.config/sway/config. კომპიგურაციის ნიმუში ხშირ შემთხვევაში არის /etc/sway/config.
გაუშვი man 5 sway კონპიგურაციაზე ინფორმაციის მისაღებად.

გაშვება

გაუშვი sway TTY-ისთვის. ზოგიერთმა ლოგინ მენეჯერმა შეიძლება იმუშავოს, მაგრამ არ
არის მხარდაჭერილი sway-სგან (როგორც წესი კარგად მუშაობს gdm).


File: README.gr.md

Sway

Το sway ένα i3-συμβατό Wayland compositor. Διαβάστε το FAQ. Μπείτε στο
IRC channel (#sway on irc.libera.chat).

Υπογραφές δημοσιεύσεων

Οι εκδόσεις είναι υπογεραμμένες με E88F5E48 και δημοσιευμένες στο GitHub.

Εγκατάσταση

Από πακέτα

Το Sway είναι διαθέσιμο σε πολλά distributions. Δοκιμάστε εγκαταστώντας το "sway" package για
το δικό σας.

Εάν ενδιαφέρεστε για packaging του sway για το distribution σας, να πάτε στο IRC
channel ή στείλτε ένα email στο [email protected] για συμβουλές.

Compiling από πηγή

Τσεκάρετε αυτό το wiki page εάμα θέλετε να κάνετε build το HEAD του
sway και wlroots γιά τεστάρισμα ή development.

Εγκατάσταση των dependencies:

  • meson *
  • wlroots
  • wayland
  • wayland-protocols *
  • pcre2
  • json-c
  • pango
  • cairo
  • gdk-pixbuf2 (προαιρετικό: system tray)
  • scdoc (προαιρετικό: man pages) *
  • git (προαιρετικό: πληροφορίες εκδώσεων) *

*Compile-time dep

Τρέξτε αυτά τα commands:

text
meson setup build/
ninja -C build/
sudo ninja -C build/ install

Configuration

Εάν ήδη χρησιμοποιήτε το i3, αντιγράψτε το i3 config σας στο ~/.config/sway/config και
θα δουλέψει out of the box. Αλλιώς, αντιγράψτε το sample configuration αρχείο στο
~/.config/sway/config. Το οποίο συνήθως βρίσκεται στο /etc/sway/config.
Κάντε run man 5 sway για πληροφορίες τού configuration.

Τρέχοντας

Τρέξτε sway από ένα TTY. Μερίκα display managers μπορεί να δουλέψουν αλλά δέν είναι συμβατά με
το sway (το gdm γνωρίζεται να δουλέβει σχετικά καλά).


File: README.hi.md

sway

sway एक i3-अनुकूल
Wayland Compositor है।
FAQ पढिये। IRC
Channel

(irc.libera.chat पर #sway) में भी जुडिये।

रिलीज हस्ताक्षर

रिलीजें
E88F5E48
से साइन होतें हैं और Github पर प्रकाशित होते हैं।

इंस्टौलेशन

पैकेजों के द्वारा

Sway कई distributions में उप्लब्ध है। आप अपने में "sway" नामक पैकेज इंस्टौल करके देख
सकते हैं।

Source से compile करके

यदि आप परीक्षण और विकास के लिए sway और wlroots के नवीनतम संस्करण बनाना
चाहते हैं, तो यह विकी
पृष्ठ
देखें।

निर्भरताएं:

  • meson *
  • wlroots
  • wayland
  • wayland-protocols *
  • pcre2
  • json-c
  • pango
  • cairo
  • gdk-pixbuf (वैकल्पिक: system tray के लिये)
  • scdoc (वैकल्पिक: man पृष्ठों के लिये)
    *
  • git (वैकल्पिक: संस्करण जानने के लिये)

* Compilation के समय आवश्यक

ये commands चलाएं:

text
meson setup build/
ninja -C build/
sudo ninja -C build/ install

Configuration

अगर आप पहले से ही i3 का उपयोग करते हैं तो अपने i3 config को
~/.config/sway/config में copy कर लीजिये और वह बिना किसी परिवर्तन के काम
करेगा। अन्यथा, नमूने configuration file को ~/.config/sway/config में copy
कर लीजिये। यह सामान्यतः /etc/sway/config में पाया जाता है। man 5 sway से आप configuration के बारे में जानकारी प्राप्त कर सकते हैं।

चलाना

आप एक tty से sway को चला सकते हैं। कुछ display managers काम करते हैं परन्तु ये
sway के द्वारा समर्थित नहीं है (gdm के बारे में जाना गया है कि वह सही काम करता
है)।