Just My Socks Usage

A lightweight plugin to track your Just My Socks data usage.

Your API Link remains private. This plugin only connects to the official Just My Socks API server to retrieve data. Your API Link and any related information are never uploaded to or shared with any third-party platforms.

Features

Two Display Modes: Choose between a text-based overview or a linear progress bar.

Anti-Flicker Rendering: Only pushes updates when data changes, eliminating screen flashes.

Smart Polling: Auto-refreshes every 60 seconds. Prevents duplicate timers and API rate limits (HTTP 429).

Manual Refresh: Press the physical key to force an immediate data fetch.

Error Handling: Displays an ERR / OFFLINE state during network drops and recovers automatically.

Included Actions

Data Usage (Text): Monochrome dashboard showing remaining GB and usage percentage.

Data Usage (Percentage): Visual layout focusing on usage percentage with a horizontal progress bar

Setup Instructions

Configure the API link once in the Stream Deck Property Inspector:

Log in to Just My Services > select your active proxy.

Click the API tab.

Locate the Bandwidth Counter section and copy the link. (Example: https://justmysocks6.net/members/getbwcounter...)

Paste the URL into the API Link field in the Stream Deck software.

Requirements

Stream Deck software (v6.9+)

Active Just My Socks service with API access

Open Source & Feedback

This plugin is free and open-source. Suggestions and bug reports are welcome!

GitHub: https://github.com/JupiterOdyssey/just-my-socks-usage

Fixed an issue where the numeric text was positioned too close to the left edge.

Added a security reminder about API Link privacy in the plugin settings.