Making your own theme

आप ~/.config/omaros/themes में अपनी खुद की थीम जोड़ सकते हैं। बस मौजूदा थीमों में से किसी एक को आधार के रूप में कॉपी करें (/usr/share/omaros/themes में देखें), फिर अपनी खुशी के अनुसार बदलाव करें। जब तक आपकी थीम उस फ़ोल्डर के अंदर है, यह थीम चयन मेनू में शामिल होगी।

मुख्य फ़ाइल जिसे आपको बदलना है वह colors.toml है। यह उस रंग सेट को परिभाषित करती है जिसका इस्तेमाल फिर टर्मिनल (Foot/Alacritty/Ghostty/Kitty), btop, Chromium, Hyprland, Neovim, Helix, VSCode, Obsidian और पूरे OmarOS शेल (टॉप बार, मेनू, सूचनाएँ, OSD और लॉक स्क्रीन) के लिए कॉन्फ़िगरेशन बनाने के लिए किया जाता है।

आप रंगों के साथ खेलने और बैकग्राउंड खोजने के लिए एक सुंदर GUI इंटरफ़ेस का इस्तेमाल करके नई थीम बनाने के लिए शामिल Aether एप्लिकेशन का भी इस्तेमाल कर सकते हैं। बस इसे Super + Alt + Space पर ऐप ग्रिड से शुरू करें।

एक इंस्टॉल की गई थीम में क्या हो सकता है

~/.config/omaros/themes में आप खुद जो थीम लिखते हैं उसमें जो चाहें हो सकता है — यह आपकी मशीन और आपकी फ़ाइल है, और OmarOS यह सब लागू करता है।

किसी और के रेपो से omaros theme install से आप जो थीम इंस्टॉल करते हैं वह वह सब कुछ रखती है जो रंग है, और उन मुट्ठी भर फ़ाइलों को खो देती है जो आपकी मशीन पर कोड चलाएँगी: कोई भी .lua फ़ाइल, टर्मिनल कॉन्फ़िग (alacritty.toml, foot.ini, ghostty.conf, kitty.conf), और vscode.json। थीम की hyprland.lua वह Lua है जो आपका कंपोज़िटर लॉगिन पर चलाता है, एक टर्मिनल कॉन्फ़िग उस प्रोग्राम का नाम देता है जो आपका टर्मिनल शुरू करता है, और vscode.json इंस्टॉल करने के लिए एक VSCode एक्सटेंशन का नाम देता है। किसी की थीम इंस्टॉल करने से यह बदलना चाहिए कि आपका डेस्कटॉप कैसा दिखता है, कभी यह नहीं कि वह क्या चलाता है।

बाकी सब कुछ ठीक वैसे ही काम करता है जैसे थीम लेखक ने लिखा था — btop.theme, chromium.theme, helix.toml, icons.theme, shell.toml, बैकग्राउंड और प्रीव्यू सभी रखे जाते हैं। केवल जो हटाया गया था वह आपकी मशीन पर colors.toml से फिर से बनाया जाता है।

OmarOS दोनों को इस बात से अलग बताता है कि क्या थीम के अंदर उसका अपना git रेपो है, जो वह है जो omaros theme install क्लोन करने पर पीछे छोड़ता है। इसलिए आपने जो थीम लिखी वह आपकी रहती है, और जो आपने इंटरनेट से खींची वह रंग रहती है।

लाइट मोड

अगर आप लाइट मोड थीम बना रहे हैं, तो अपने colors.toml के शीर्ष पर mode = "light" सेट करें। फिर यह सभी ऐप्स के लिए स्वचालित रूप से लाइट मोड के साथ जोड़ी जाएगी। (आपकी थीम के रूट में light.mode नामक एक खाली फ़ाइल डालने का पुराना तरीका भी अभी भी काम करता है।)

आइकन रंग

अगर आप फ़ाइल मैनेजर आइकनों को अपनी थीम से रंग-मिलान करना चाहते हैं, तो icons.theme नामक एक फ़ाइल जोड़ें जिसमें उस आइकन सेट का नाम हो जिसे आप इस्तेमाल करना चाहते हैं। डिफ़ॉल्ट रूप से, विकल्प हैं: Yaru Yaru-blue Yaru-dark Yaru-magenta Yaru-olive Yaru-prussiangreen Yaru-purple Yaru-red Yaru-sage Yaru-wartybrown Yaru-yellow।

अनलॉक इमेज

unlock.png और preview-unlock.png छवियों के साथ आपूर्ति की गई थीम Style > Unlock के तहत सूचीबद्ध होंगी। आपका unlock.png अधिमानतः एक पारदर्शी png होना चाहिए। और आप omaros plymouth preview का इस्तेमाल करके प्रीव्यू इमेज बना सकते हैं।

उन ऐप्स को थीम करना जिन्हें OmarOS कवर नहीं करता

अगर आप किसी ऐसे ऐप का इस्तेमाल करते हैं जो उस सूची में नहीं है, तो आप एक टेम्पलेट के साथ OmarOS को खुद उसे थीम करना सिखा सकते हैं। ~/.config/omaros/themed/ में एक फ़ाइल डालें जिसका नाम उस कॉन्फ़िग के नाम पर हो जो यह बनाती है और साथ में .tpl एक्सटेंशन हो, और कॉन्फ़िग को {{ background }}, {{ foreground }}, {{ accent }}, {{ red }}, {{ color0 }} से {{ color15 }} तक, और पैलेट के बाकी हिस्सों को प्लेसहोल्डर के रूप में लिखें। हर बार जब आप थीम बदलते हैं, फ़ाइल उस थीम के रंगों के साथ फिर से बनाई जाती है।

उस फ़ोल्डर में कॉपी करने के लिए एक पूरी तरह कमेंट की गई alacritty.toml.tpl.sample है — यह हर उस वेरिएबल को सूचीबद्ध करती है जिसे आप इस्तेमाल कर सकते हैं, साथ ही उन ऐप्स के लिए _strip और _rgb मॉडिफ़ायर जो अपने रंगों को # के बिना या दशमलव RGB के रूप में चाहते हैं। आपके टेम्पलेट OmarOS के अपने टेम्पलेटों पर प्राथमिकता लेते हैं, इसलिए आप इसका इस्तेमाल यह ओवरराइड करने के लिए भी कर सकते हैं कि कोई बिल्ट-इन ऐप कैसे थीम किया जाता है।

अपनी थीम वितरित करना

अगर आप अपनी थीम वितरित करना चाहते हैं ताकि अन्य लोग इसका इस्तेमाल कर सकें, तो आपको इसे GitHub जैसे किसी सार्वजनिक git सर्वर पर रखना होगा। फिर लोग उस URL का इस्तेमाल करके OmarOS मेनू में Install > Style > Theme का इस्तेमाल करके इसे इंस्टॉल कर सकते हैं। यह अनुशंसा की जाती है कि आप omaros-[themename]-theme नामकरण परंपरा का पालन करें, क्योंकि इंस्टॉलेशन के बाद थीम थीम चयन मेनू में सही ढंग से सिर्फ़ [themename] के रूप में दिखाई देगी।

वह बचा हुआ [themename] थीम का डायरेक्टरी नाम बन जाता है, इसलिए यह ऐसा होना चाहिए जिसे OmarOS सुरक्षित रूप से इधर-उधर दे सके: यह एक अक्षर, एक अंक या एक अंडरस्कोर से शुरू होना चाहिए, और बाकी में अक्षर, अंक, ., _, + और - हो सकते हैं। बड़े अक्षर आपके लिए छोटे अक्षरों में बदल दिए जाते हैं, लेकिन बाकी कुछ भी — एक स्पेस, एक कोट, एक गैर-अंग्रेज़ी कैरेक्टर — डायरेक्टरी नाम में बदलने के बजाय इंस्टॉल समय पर अस्वीकार कर दिया जाता है। इसलिए omaros-tokyo-night-theme, omaros-flexoki_light-theme, और omaros-c++-theme सभी ठीक से इंस्टॉल होते हैं।

याद रखें कि एक बार जब यह किसी रेपो से इंस्टॉल हो जाती है, तो इसमें शामिल कोई भी .lua, टर्मिनल कॉन्फ़िग या vscode.json हटा दिया जाता है, इसलिए थीम को उनके इर्द-गिर्द न बनाएँ।