इस प्रोजेक्ट के बारे में

यह परियोजना Apple Silicon पर microsandbox microVM में डिस्प्ले और GPU समर्थन के लिए एक स्वतंत्र, अनौपचारिक परीक्षण मंच है। microsandbox Linux microVM चलाता है लेकिन इसमें कोई डिस्प्ले पथ नहीं है; यह परियोजना अपने रनटाइम के एक फोर्क में एक पथ रखती है: एक 2D virtio-gpu स्कैनआउट जो मूल macOS विंडो में दिखाया जाता है, virtio-input, vsock पर एक टेक्स्ट क्लिपबोर्ड, और CoreAudio के माध्यम से virtio-snd। कार्यभार एक पूर्ण Omarchy डेस्कटॉप (Hyprland + Quattro) है, जिसे चुना गया है क्योंकि एक वास्तविक कंपोज़िटर उन समस्याओं को उजागर करता है जो एक परीक्षण पैटर्न नहीं करेगा। GPU स्थिति: अतिथि CPU पर Mesa के llvmpipe के साथ रेंडर करता है और virtio-gpu तैयार फ्रेम को होस्ट तक ले जाता है। अभी तक कुछ भी हार्डवेयर-त्वरित नहीं है; Venus (Mac GPU पर MoltenVK के माध्यम से अतिथि Vulkan) को अगले प्रयोग के रूप में वर्णित किया गया है। यह क्या प्रदान करता है: - एक स्थायी डेस्कटॉप VM: एक बार बनाएं, विंडो बंद करें और फिर से खोलें, या फ़ाइलों और सेटिंग्स के साथ रोकें और फिर से शुरू करें। - मूल Mac एकीकरण: macOS डिस्प्ले विंडो, कीबोर्ड और पॉइंटर इनपुट, टेक्स्ट क्लिपबोर्ड सिंक, और ऑडियो आउटपुट। - सॉफ्टवेयर रेंडरिंग के लिए ट्यून किया गया डेस्कटॉप: दो डिस्प्ले प्रोफाइल (हल्का 1600x900, मानक 1920x1080), बड़ा टेक्स्ट, अपारदर्शी विंडो, और अक्षम एनिमेशन, ब्लर और छाया। एक glFlush-to-glFinish शिम कंपोज़िटर को प्रत्येक कमिट से पहले llvmpipe की प्रतीक्षा कराता है। - पहले बूट से एप्लिकेशन: Chromium, Nautilus, Foot, CJK फ़ॉन्ट और Fcitx5 Pinyin, काम करने वाले डिफ़ॉल्ट ब्राउज़र और फ़ाइल-मैनेजर एसोसिएशन के साथ। - स्पष्ट फ़ाइल साझाकरण: एक लिखने योग्य Shared निर्देशिका ~/Shared पर माउंट की गई, जो टॉप बार और फ़ाइल-मैनेजर साइडबार से पहुंच योग्य है। - चेकसम किए गए रनटाइम और फर्मवेयर डाउनलोड और प्रोजेक्ट-स्थानीय VM स्थिति के साथ एक पृथक रनटाइम। - रिकॉर्ड किया गया सत्यापन: लॉन्चर और रिलीज़ परीक्षण, अतिथि छवि जांच, Mac स्मोक टेस्ट, स्क्रीनशॉट और परीक्षण की गई छवि से जुड़े माप। त्वरित शुरुआत के लिए Hypervisor.framework, Git, Python 3.9+, Homebrew, और होस्ट लाइब्रेरी (slp/krun/virglrenderer, molten-vk, libepoxy) के साथ Apple Silicon Mac की आवश्यकता होती है। कमांड: bin/setup पिन किए गए रनटाइम और फर्मवेयर को डाउनलोड और सत्यापित करता है; bin/doctor होस्ट समर्थन की जांच करता है; bin/run डेस्कटॉप बनाता है और उसकी मूल विंडो खोलता है। पहला रन लगभग 6 GB की प्रकाशित अतिथि छवि डाउनलोड करता है। प्रत्येक VM डिफ़ॉल्ट रूप से 4 vCPU, 4G RAM और 16G लिखने योग्य डिस्क का उपयोग करता है। चेकआउट एक छोटे पथ पर होना चाहिए क्योंकि रनटाइम सॉकेट पथ 104 बाइट्स में फिट होने चाहिए। दैनिक संचालन में bin/run (बनाएं, फिर से शुरू करें या फिर से खोलें), bin/run --no-display, bin/pause, bin/stop, bin/msb list, bin/screenshot, और bin/doctor शामिल हैं। कई नामित डेस्कटॉप अलग-अलग VNC पोर्ट के साथ समवर्ती रूप से चल सकते हैं। रीसेट bin/reset --name work --yes के माध्यम से स्पष्ट है। Mac Command कुंजी Omarchy के अंदर Super से मैप होती है; शॉर्टकट में टर्मिनल के लिए Command+Enter, शॉर्टकट के लिए Command+K, ब्राउज़र के लिए Command+Shift+Enter, फ़ाइल मैनेजर के लिए Command+Shift+F, और अंग्रेजी/चीनी पिनयिन इनपुट स्विच करने के लिए Ctrl+Space शामिल हैं। VNC डिफ़ॉल्ट डेस्कटॉप के लिए vnc://127.0.0.1:5901 पर उपलब्ध है; अतिथि लिसनर में कोई प्रमाणीकरण नहीं है और इसे केवल लूपबैक पर अग्रेषित किया जाता है। क्लिपबोर्ड छवियां समर्थित नहीं हैं। कॉन्फ़िगरेशन चर में NAME, PROFILE, CPUS, MEMORY, ROOT_DISK, SHARED_DIR, VNC_PORT, TAG, MSB_GPU_DISPLAY, साथ ही उन्नत ओवरराइड MSB, MSB_LIBKRUNFW_PATH और MSB_HOME शामिल हैं। सत्यापन कमांड में bin/check, bin/smoke --profile light, bin/smoke --profile standard, bin/frame-check और bin/publish --check शामिल हैं। डायग्नोस्टिक्स में bin/measure-display और bin/display-shot शामिल हैं, जो एकल display.sock व्यूअर स्लॉट से जुड़ते हैं और उस VM के लिए किसी भी मौजूदा मूल व्यूअर को बंद करते हैं। परियोजना द्वारा दर्ज निष्कर्षों में शामिल हैं: NO_VIRGL के साथ virtio-gpu डिवाइस macOS पर हर 2D कमांड को अस्वीकार करता है इसलिए होस्ट को कभी फ्रेम नहीं मिलता है, और फोर्क एक 2D-केवल मोड जोड़ता है; Hyprland DRM ड्राइवर नाम से रेंडरिंग की प्रतीक्षा करने का निर्णय लेता है, इसलिए virtio-gpu पर यह आधे-खींचे llvmpipe फ्रेम स्कैन करता है, जिसे glFlush-to-glFinish शिम द्वारा ठीक किया गया है; एक डेस्कटॉप VM को लगभग 30 ms में रोका और फिर से शुरू किया जा सकता है लेकिन चेकपॉइंट नहीं किया जा सकता क्योंकि virtio-gpu और virtio-snd शांत नहीं हो सकते; और macOS 27 SDK के खिलाफ स्थानीय रूप से निर्मित msb HVF चेकपॉइंट नहीं ले सकता। अपस्ट्रीम स्थिति: डिस्प्ले परिवर्तन अगस्त 2026 में microsandbox और msb_krun को प्रस्तावित किए गए थे और 2026-09-23 को समीक्षा के लिए बहुत बड़े और बहुत पीछे होने के कारण बिना समीक्षा के वापस ले लिए गए थे। फोर्क को पूरे रूप में प्रस्तावित करने के बजाय एक परीक्षण वाहन के रूप में रखा गया है। यह परियोजना microsandbox, libkrun, Omarchy या Hyprland से संबद्ध या समर्थित नहीं है। यह omarchy-microsandbox का पूरक है, जो VMs के प्रबंधन के लिए एक Omarchy प्लगइन है; यहां Omarchy डेस्कटॉप स्वयं VM के अंदर चलता है। MIT के तहत लाइसेंस प्राप्त है, शामिल रनटाइम और अतिथि सॉफ्टवेयर अपने अपस्ट्रीम लाइसेंस बनाए रखते हैं।