DeepSeek Usage Plugin for Noctalia

A balance and API credit monitor for Noctalia shell.

Plugin

Plugin ID: coder/deepseek_usage

Widget(s):

• bar — bar widget entry.

Panel(s):

• panel — panel entry.

Requirements

• xdg-open — used by the top-up button to open platform.deepseek.com/top_up in the default browser.

External dependencies

• xdg-open

Usage

Widget

• Add the bar widget to your bar to display usage.

Panel

• Toggle the plugin panel with the following IPC command: noctalia msg panel-toggle coder/deepseek_usage:panel

Features

• Bar Widget: Shows live balance directly on your Noctalia bar.
• Low Balance Warning: Visual indicator and desktop notifications when credits drop below your set threshold.
• Interactive Panel: Displays account wallet summary, local trend graph, and quick top-up action.
• One-Click Top-Up: "Add Credits" button opens platform.deepseek.com/top_up directly in your browser.

Settings

Configure the update interval and API key in Noctalia plugin settings.

• DeepSeek API Key: Create an API key at platform.deepseek.com/api_keys and enter it in plugin settings.
• Refresh Interval: Default is 15 minutes.
• Low Balance Warning: Default threshold is 2.00.