Getting started
Install Cosmos on macOSติดตั้ง Cosmos บน macOS
Download Cosmos, drag Cosmos.app into /Applications, then open it. Alpha builds may require right-click Open until the public notarized release is shipped.ดาวน์โหลด Cosmos, ลาก Cosmos.app เข้าไปใน /Applications แล้วเปิดใช้งาน Alpha build อาจต้องคลิกขวา Open จนกว่าจะปล่อย public notarized release
Installing Cosmos on macOS takes two steps: download the .dmg, then drag the app into /Applications and open it. Cosmos is currently an alpha macOS build; public notarized distribution is the target for the polished public release.
Before you start
- Apple Silicon (M-series) is the primary, fully supported target. Intel Macs and other operating systems are in development.
- You need the latest Cosmos
.dmgdownload. Current alpha build:v0.2.29-demo.
1. Download Cosmos
Download the latest .dmg from the Download button or releases page. Alpha builds are signed for local testing, but may not be Apple-notarized yet. If macOS asks for confirmation, use the fallback below.
2. Install the app
Open the downloaded .dmg and drag Cosmos.app into your /Applications folder, just like any other Mac app.
3. Open Cosmos
Open Cosmos from /Applications, Launchpad, or Spotlight.
open /Applications/Cosmos.app
After the first successful open, you launch Cosmos normally from Launchpad or the Applications folder.
What if macOS still blocks the app?
If macOS reports that it cannot verify Cosmos, right-click Cosmos.app in /Applications, choose Open, then confirm. If that still fails, use the fallback in Troubleshooting. Public notarized builds should not require xattr.
Which Macs are supported?
Apple Silicon (M-series) is the primary, fully supported target. Intel Macs and other operating systems are in active development.
Is the old xattr fallback safe?
Yes, when it is needed for an alpha build you trust and downloaded from the official Cosmos link. xattr -cr recursively clears extended attributes — including the quarantine flag — on the app bundle you just installed. It does not modify the app's code or your data.
macOS still says Cosmos can't be opened — what now?
Confirm that you downloaded the newest .dmg from the official Cosmos site. If right-click Open does not work, see Troubleshooting or contact support with the exact macOS warning text.
การติดตั้ง Cosmos บน macOS มีสองขั้นตอน: ดาวน์โหลดไฟล์ .dmg แล้วลากแอปเข้าไปใน /Applications จากนั้นเปิดใช้งาน ตอนนี้ Cosmos ยังเป็น alpha macOS build ส่วน public notarized distribution จะมากับ release ที่พร้อมเปิดสาธารณะมากขึ้น
ก่อนเริ่ม
- Apple Silicon (ชิปตระกูล M) เป็นเป้าหมายหลักที่รองรับเต็มรูปแบบ ส่วน Mac ที่ใช้ Intel และระบบปฏิบัติการอื่น ๆ ยังอยู่ระหว่างการพัฒนา
- คุณต้องมีไฟล์
.dmgเวอร์ชันล่าสุดของ Cosmos เวอร์ชัน alpha ปัจจุบันคือv0.2.29-demo
1. ดาวน์โหลด Cosmos
ดาวน์โหลดไฟล์ .dmg เวอร์ชันล่าสุดจากปุ่ม Download หรือหน้า releases บิลด์ alpha ถูก sign สำหรับการทดสอบ local แต่อาจยังไม่ได้ผ่าน Apple notarization ถ้า macOS ขอให้ยืนยัน ให้ใช้ fallback ด้านล่าง
2. ติดตั้งแอป
เปิดไฟล์ .dmg ที่ดาวน์โหลดมา แล้วลาก Cosmos.app เข้าไปในโฟลเดอร์ /Applications เหมือนกับแอป Mac ทั่วไป
3. เปิด Cosmos
เปิด Cosmos จาก /Applications, Launchpad หรือ Spotlight
open /Applications/Cosmos.app
หลังจากเปิดสำเร็จครั้งแรกแล้ว คุณสามารถเปิด Cosmos ได้ตามปกติจาก Launchpad หรือโฟลเดอร์ Applications
ถ้า macOS ยังบล็อกแอปอยู่ล่ะ?
ถ้า macOS แจ้งว่าตรวจสอบ Cosmos ไม่ได้ ให้คลิกขวาที่ Cosmos.app ใน /Applications เลือก Open แล้วกดยืนยัน ถ้ายังไม่ผ่าน ให้ใช้วิธี fallback ในหน้า Troubleshooting บิลด์ public ที่ notarized แล้วไม่ควรต้องใช้ xattr
Mac รุ่นไหนบ้างที่รองรับ?
Apple Silicon (ชิปตระกูล M) เป็นเป้าหมายหลักที่รองรับเต็มรูปแบบ ส่วน Mac ที่ใช้ Intel และระบบปฏิบัติการอื่น ๆ ยังอยู่ระหว่างการพัฒนาอย่างต่อเนื่อง
fallback xattr แบบเก่าปลอดภัยไหม?
ปลอดภัยเมื่อจำเป็นต้องใช้กับ alpha build ที่คุณเชื่อถือและดาวน์โหลดจากลิงก์ Cosmos ทางการ xattr -cr จะล้าง extended attributes แบบ recursive รวมถึง quarantine flag บน app bundle ที่คุณเพิ่งติดตั้ง โดยไม่แก้ไขโค้ดของแอปหรือข้อมูลของคุณ
macOS ยังขึ้นว่าเปิด Cosmos ไม่ได้ ต้องทำยังไง?
ตรวจสอบก่อนว่าคุณดาวน์โหลด .dmg ล่าสุดจากเว็บ Cosmos ทางการ ถ้า right-click Open ยังไม่ผ่าน ให้ดู Troubleshooting หรือติดต่อ support พร้อมข้อความเตือนจาก macOS แบบเต็ม
- Atitechs EngineeringMaintainer