CrossOverLicence

Kích hoạt license CrossOver trên macOS bằng self-sign (RSA + tie.pub).

Tính năng

• Kích hoạt license, bỏ qua hạn chế trial
• App macOS (CrossOverLicence.app) — double-click để chạy
• Tự nhắc tải CrossOver nếu chưa cài
• Dịch vụ bảo trì tự động (tùy chọn, mỗi 30 ngày)
• Khôi phục bản CrossOver gốc (restore)

Yêu cầu

• macOS 10.13 trở lên
• CrossOver đã cài tại /Applications/CrossOver.app hoặc ~/Applications/CrossOver.app
• openssl, codesign (có sẵn trên macOS)

Cài đặt

Cách 1: Tải app (khuyên dùng)

1. Tải bản mới nhất từ GitHub Releases
2. Mở CrossOverLicence.dmg, kéo app ra hoặc chạy trực tiếp

Lần đầu mở — nếu macOS báo không thể xác minh app:

1. Chuột phải vào CrossOverLicence.app → Mở
2. Bấm Mở trong hộp thoại xác nhận (chỉ cần một lần)

Hoặc chạy Terminal:

xattr -cr ~/Downloads/CrossOverLicence.app
open ~/Downloads/CrossOverLicence.app

Cách 2: Clone repo

git clone https://github.com/unclecatvn/unlock-crossover.git
cd unlock-crossover
chmod +x CrossOverLicence.sh
./CrossOverLicence.sh activate

Sử dụng

Kích hoạt nhanh

./CrossOverLicence.sh activate

Script sẽ:

1. Đóng CrossOver nếu đang chạy
2. Tạo cặp khóa RSA và patch tie.pub trong CrossOver.app
3. Ký lại app và tạo file license

Cài dịch vụ bảo trì

./CrossOverLicence.sh install

Kích hoạt license và cài LaunchAgent chạy lại mỗi 30 ngày.

Các lệnh khác

Lệnh	Mô tả
activate	Kích hoạt license (mặc định)
install	Kích hoạt + cài dịch vụ bảo trì
restore	Khôi phục CrossOver.app gốc
repair	Khôi phục gốc rồi kích hoạt lại
uninstall	Gỡ dịch vụ và file license
help	Hiển thị trợ giúp

Biến môi trường

Biến	Mặc định
LICENSE_CUSTOMER	Licensed User
LICENSE_EMAIL	user@local.dev
LICENSE_EXPIRES	2035/12/31

LICENSE_CUSTOMER="Tên của bạn" ./CrossOverLicence.sh activate

Cách hoạt động

1. Khóa RSA — tạo tại ~/CrossOverLicence/keys/
2. Patch tie.pub — thay public key trong CrossOver.app bằng khóa của bạn
3. License — tạo và ký file tại ~/Library/Preferences/com.codeweavers.CrossOver.license
4. Preferences — tắt kiểm tra cập nhật tự động

Sau khi CrossOver cập nhật, chạy lại activate.

Vị trí file

File	Đường dẫn
License	~/Library/Preferences/com.codeweavers.CrossOver.license
Chữ ký license	~/Library/Preferences/com.codeweavers.CrossOver.sha256
Preferences	~/Library/Preferences/com.codeweavers.CrossOver.plist
Khóa RSA	~/CrossOverLicence/keys/
Backup app gốc	~/CrossOverLicence/CrossOver.app.original
LaunchAgent	~/Library/LaunchAgents/com.codeweavers.CrossOver.license.plist

Xử lý sự cố

macOS chặn mở app

Xem mục Cài đặt → Lần đầu mở hoặc file HUONG-DAN-MO.txt trong DMG.

Kích hoạt thất bại / cần quyền ghi

• Cấp Full Disk Access cho Terminal (System Settings → Privacy & Security)
• Patch /Applications có thể yêu cầu mật khẩu admin

CrossOver không chạy

pkill -9 -f CrossOver
pkill -9 -f wineserver
killall cfprefsd
./CrossOverLicence.sh activate

Gỡ hoàn toàn

./CrossOverLicence.sh uninstall
./CrossOverLicence.sh restore   # khôi phục app gốc nếu có backup

Phát triển & Release

./build/build.sh    # build/out/CrossOverLicence.{app,dmg,zip}

Release tự động qua GitHub Actions khi cập nhật CHANGELOG.md — xem CHANGELOG.md.

Disclaimer

⚠️ Chỉ dùng cho mục đích học tập / nghiên cứu.

Nếu CrossOver hữu ích với bạn, hãy mua license chính thức tại CodeWeavers.

License

MIT — sử dụng trên trách nhiệm của bạn.