ویجت نرخ طلا، ارز و رمزارز

یک برنامه دسکتاپ مدرن و زیبا برای نمایش نرخ لحظه‌ای طلا، ارزهای دیجیتال و اطلاعات سیستمی با رابط کاربری شفاف و کاربرپسند.

✨ ویژگی‌ها

📊 نمایش اطلاعات متنوع

• طلا و سکه: قیمت لحظه‌ای طلای ۱۸ عیار و سکه امامی
• ارزهای دیجیتال: بیت‌کوین، اتریوم و تتر با آیکون‌های اختصاصی SVG
• ارز: نرخ دلار آمریکا
• آب و هوا: دما و وضعیت آب و هوایی شهر ماهشهر
• سیستم: نام کامپیوتر و آدرس IP محلی

🎨 رابط کاربری مدرن

• طراحی شیشه‌ای با شفافیت و سایه زیبا
• آیکون‌های SVG اختصاصی برای بیت‌کوین، تتر و دلار
• فونت فارسی Vazirmatn برای نمایش بهتر متن‌ها
• اعداد فارسی برای نمایش قیمت‌ها
• اندازه ثابت و بهینه (۲۲۰×۵۰ پیکسل)

🖱️ ناوبری هوشمند

• کلیک سمت راست (ناحیه قیمت): نمایش اطلاعات بعدی
• کلیک سمت چپ (ناحیه آیکون): نمایش اطلاعات قبلی
• کلیک راست موس: بستن برنامه
• چرخه‌ای بین ۹ حالت نمایش مختلف

🔄 به‌روزرسانی خودکار

• قیمت‌ها هر ۱۵ ثانیه به‌روزرسانی می‌شوند
• آب و هوا هر ۱۰ دقیقه به‌روزرسانی می‌شود
• استفاده از APIهای معتبر ایرانی و بین‌المللی

🎯 قابلیت‌های پیشرفته

• پنجره بدون قاب (frameless) برای ظاهر مدرن
• موقعیت ثابت در گوشه بالا-راست صفحه
• رفتار عادی پنجره (قابل پوشش توسط سایر برنامه‌ها)
• اجرای در پس‌زمینه با threadهای جداگانه

📋 نیازمندی‌ها

• Python 3.8 یا بالاتر
• PyQt6
• requests
• beautifulsoup4 (اختیاری)
• urllib3

🚀 نصب و راه‌اندازی

۱. کلون کردن مخزن

git clone https://github.com/PersianXM/GoldPriceWidget.git
cd GoldPriceWidget

۲. نصب وابستگی‌ها

pip install -r requirements.txt

یا نصب دستی:

pip install PyQt6 requests beautifulsoup4 urllib3

۳. اجرای برنامه

python app.py

📖 نحوه استفاده

چرخه نمایش اطلاعات

برنامه بین ۹ حالت نمایش چرخشی جابجا می‌شود:

1. 🌐 آدرس IP - نمایش IP محلی سیستم
2. 💻 نام سیستم - نمایش نام کامپیوتر
3. 🌤️ آب و هوا - دما و وضعیت آب و هوایی
4. 💵 دلار - نرخ دلار به تومان
5. ₮ تتر - نرخ تتر به تومان
6. ₿ بیت‌کوین - قیمت بیت‌کوین
7. ⟠ اتریوم - قیمت اتریوم
8. 🪙 سکه - قیمت سکه امامی
9. 🏆 طلا - قیمت طلای ۱۸ عیار

کنترل ماوس

• کلیک سمت راست روی قیمت: نمایش اطلاعات بعدی ⏭️
• کلیک سمت چپ روی آیکون: نمایش اطلاعات قبلی ⏮️
• کلیک راست موس (هر جایی): بستن برنامه ❌

تنظیمات API

برای فعال‌سازی آب و هوای دقیق، API Key OpenWeatherMap را در کد تنظیم کنید:

self.api_key = "YOUR_OPENWEATHERMAP_API_KEY"  # در فایل app.py

🛠️ توسعه

ساختار پروژه

GoldPriceWidget/
├── app.py                 # برنامه اصلی
├── test_currencies.py     # تست واحد
├── test_api.py           # تست API
├── test_formatting.py    # تست فرمت‌بندی
├── requirements.txt      # وابستگی‌ها
├── Vazirmatn-Regular.ttf # فونت فارسی
├── README.md             # این فایل
└── .gitignore           # فایل‌های نادیده

افزودن حالت نمایش جدید

1. آیکون SVG را در ابتدای فایل app.py تعریف کنید
2. ویجت جدید را در __init__ ایجاد کنید
3. آن را به QStackedWidget اضافه کنید
4. نام آن را به لیست display_mode اضافه کنید

APIها و منابع داده

• طلا و ارز: BRS API (brsapi.ir)
• رمزارزها: BRS API (brsapi.ir)
• آب و هوا: OpenWeatherMap API + wttr.in (fallback)

📸 تصاویر برنامه

تصاویر برنامه به زودی اضافه خواهد شد

🤝 مشارکت

مشارکت‌ها welcome هستند! لطفاً برای مشارکت:

1. Fork کنید
2. Branch جدید ایجاد کنید (git checkout -b feature/AmazingFeature)
3. تغییرات خود را commit کنید (git commit -m 'Add some AmazingFeature')
4. Push کنید (git push origin feature/AmazingFeature)
5. Pull Request ایجاد کنید

📝 تغییرات اخیر

v2.0.0 (جاری)

• ✨ اضافه شدن نمایش بیت‌کوین، اتریوم و تتر
• 🎨 طراحی آیکون‌های SVG اختصاصی
• 🖱️ تغییر سیستم ناوبری به مبتنی بر موقعیت کلیک
• 🚫 حذف قابلیت "همیشه در بالا"
• 🌤️ اضافه شدن نمایش آب و هوا
• 💻 اضافه شدن نمایش اطلاعات سیستم
• 🔄 بهبود به‌روزرسانی خودکار

v1.0.0

• 🏆 نمایش قیمت طلا و سکه
• 🎨 رابط کاربری شیشه‌ای
• 🔄 به‌روزرسانی خودکار قیمت‌ها

📄 لایسنس

این پروژه تحت لایسنس MIT منتشر شده است. برای جزئیات بیشتر فایل LICENSE را مشاهده کنید.

👨‍💻 توسعه‌دهنده

PersianXM - GitHub

---

⭐ اگر این پروژه را مفید یافتید، لطفاً ستاره دهید!