Awesome Rates (Plasma 6 Applet)

A lightweight KDE Plasma 6 widget to display currency and crypto rates using customizable endpoints (e.g., AwesomeAPI).

• 📊 Display multiple rates (USD/BRL, BTC/USD, etc.)

• ⚙️ Fully configurable via JSON

• 🧩 Choose where each item appears:

  • Panel
  • Popup menu
  • Both
  • Hidden

• 🔢 Short/compact display mode for panel (e.g., USD 5.02 / BTC 78k)

• 📈 Shows variation indicators (▲ / ▼)

• 🔄 Auto-refresh at configurable intervals

unzip awesome-rates-plasma6.zip
kpackagetool6 --type Plasma/Applet --install package

Then:

• Right-click desktop or panel
• "Add Widgets"
• Search for Awesome Rates

Edit the JSON config inside the widget settings.

Example:

[
  {
    "name": "USD/BRL",
    "url": "https://economia.awesomeapi.com.br/json/last/USD-BRL",
    "path": "USDBRL.bid",
    "change": "USDBRL.pctChange",
    "display": "panel",
    "short": true
  },
  {
    "name": "BTC/USD",
    "url": "https://economia.awesomeapi.com.br/json/last/BTC-USD",
    "path": "BTCUSD.bid",
    "change": "BTCUSD.pctChange",
    "display": "both",
    "short": true
  }
]

• name: Label shown in UI
• url: API endpoint
• path: Dot-notation path to value
• change: Path to percentage change
• display: panel, menu, both, hidden
• short: Compact display in panel

Panel (short mode):

USD 5.02 / BTC 78k

Popup menu:

• USD/BRL — 5.02 ▲
• BTC/USD — 78,000 ▼

• Uses AwesomeAPI by default but works with any JSON API
• Ensure CORS/HTTPS compatibility if using custom endpoints

## License

MIT