Go to file
Admin f7840ed78a first commit 2026-03-20 11:31:34 +07:00
.gitignore first commit 2026-03-20 11:31:34 +07:00
main.py first commit 2026-03-20 11:31:34 +07:00
readme.md first commit 2026-03-20 11:31:34 +07:00
requirements.txt first commit 2026-03-20 11:31:34 +07:00
setup.py first commit 2026-03-20 11:31:34 +07:00

readme.md

💱 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

# 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:

HOTKEY = "ctrl+shift+c"   # Đổi phím tắt

📡 Nguồn tỉ giá

  • Live: 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