71 lines
2.2 KiB
Markdown
71 lines
2.2 KiB
Markdown
# 💱 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
|