# 💱 Currency Converter — Desktop App Cross-platform desktop app (Windows & macOS) viết bằng Python. --- ## ✨ Tính năng | Tính năng | Mô tả | | --------------------- | ---------------------------------------------------------------- | | 🔄 Chuyển đổi tiền tệ | 40+ loại tiền, tỉ giá thực từ open.er-api.com | | ⌨️ Global Hotkey | `Ctrl+Shift+C` — bôi đen số bất kỳ → nhấn hotkey → tự chuyển đổi | | 📋 Copy nhanh | Sao chép kết quả 1 click | | 🔃 Swap | Đổi chiều nhanh (From ↔ To) | | 📜 Lịch sử | 4 lần chuyển đổi gần nhất | | 🌐 Offline fallback | Nếu không có mạng, dùng tỉ giá offline gần đúng | --- ## 📦 Cài đặt ```bash # 1. Cài Python 3.10+ (nếu chưa có) # 2. Cài dependencies pip install requests pyperclip keyboard # 3. Chạy app python currency_converter.py ``` --- ## 🖱️ Cách dùng tính năng Hotkey (highlight text) 1. Bôi đen / highlight một đoạn text có chứa số (VD: "Price: 299.99") 2. Nhấn `Ctrl+C` để copy (như bình thường) 3. Nhấn **`Ctrl+Shift+C`** → App tự bật lên, điền số và chuyển đổi --- ## ⚠️ Lưu ý theo hệ điều hành ### Windows - Chạy bình thường, không cần quyền admin (trừ khi app khác chặn hotkey) ### macOS - Cần cấp quyền **Accessibility**: - System Settings → Privacy & Security → Accessibility - Thêm Terminal hoặc Python interpreter của bạn - Nếu dùng `Cmd` thay `Ctrl`, sửa dòng `HOTKEY = "ctrl+shift+c"` thành `"cmd+shift+c"` --- ## 🔧 Tuỳ chỉnh Mở file `currency_converter.py`, tìm các hằng số ở đầu file: ```python HOTKEY = "ctrl+shift+c" # Đổi phím tắt ``` --- ## 📡 Nguồn tỉ giá - **Live**: [open.er-api.com](https://open.er-api.com) (miễn phí, cập nhật hàng ngày) - **Offline**: Tỉ giá xấp xỉ được nhúng sẵn trong code