Skip to content
View DeskPulse's full-sized avatar
  • QWF Group LLC
  • US

Block or report DeskPulse

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don't include any personal information such as legal names or email addresses. Markdown supported. This note will be visible to only you.
Report abuse

Contact GitHub support about this userโ€™s behavior. Learn more about reporting abuse.

Report abuse
DeskPulse/README.md

๐Ÿš€ DeskPulse - Crypto Widget

DeskPulse Banner Website License: MIT CoinGecko API

A beautiful, transparent desktop widget for tracking cryptocurrency prices in real-time

๐ŸŒ Download from deskpulse.io

Features โ€ข Installation โ€ข Usage โ€ข Screenshots โ€ข Contributing


โœจ Features

  • ๐ŸŽจ Stunning UI - Modern glassmorphic design with animated particles
  • ๐Ÿ’Ž Transparent Background - Seamlessly blends with your desktop
  • ๐Ÿ“Š Real-time Prices - Live cryptocurrency data from CoinGecko API
  • โšก Customizable Updates - Choose update frequency (1s, 5s, 15s, 30s, 1min)
  • ๐Ÿ”ง Custom Cryptos - Add any cryptocurrency using CoinGecko ID
  • ๐Ÿ“Œ Always on Top - Keep widget visible above other windows
  • ๐ŸŽฏ 12+ Pre-loaded Coins - Bitcoin, Ethereum, BNB, Cardano, Solana, and more
  • ๐Ÿ“ˆ 24h Change Tracking - Visual indicators for price movements
  • ๐Ÿ’พ Persistent Settings - Your preferences saved automatically
  • ๐Ÿ–ฑ๏ธ Draggable Window - Position anywhere on your screen
  • ๐Ÿ”’ Privacy-Focused - All data stored locally, no account required

๐Ÿ› ๏ธ Tech Stack

  • Frontend: HTML5, CSS3, Vanilla JavaScript
  • API: CoinGecko Public API v3
  • Fonts: Google Fonts (Inter)
  • Storage: localStorage

๐Ÿ“ฆ Installation

Option 1: Download Ready-to-Use App (Recommended)

Visit deskpulse.io to download the pre-built Windows installer.

Option 2: Standalone HTML (Browser)

  1. Clone the repository:
git clone https://github.com/yourusername/deskpulse-crypto-widget.git
cd deskpulse-crypto-widget
  1. Open with a local server:
# Using Python
python -m http.server 8000

# Using Node.js
npx http-server

# Using PHP
php -S localhost:8000
  1. Open http://localhost:8000 in your browser

Option 3: Electron Desktop App

  1. Clone and install dependencies:
git clone https://github.com/yourusername/deskpulse-crypto-widget.git
cd deskpulse-crypto-widget
npm install electron --save-dev
  1. Create main.js:
const { app, BrowserWindow } = require('electron');

function createWindow() {
  const win = new BrowserWindow({
    width: 480,
    height: 600,
    transparent: true,
    frame: false,
    alwaysOnTop: true,
    webPreferences: {
      nodeIntegration: true
    }
  });

  win.loadFile('index.html');
}

app.whenReady().then(createWindow);
  1. Add to package.json:
{
  "main": "main.js",
  "scripts": {
    "start": "electron ."
  }
}
  1. Run the app:
npm start

๐ŸŽฎ Usage

Basic Usage

  1. Launch the widget - Open the application
  2. Select cryptocurrencies - Click โš™๏ธ to open settings
  3. Choose update frequency - Select your preferred refresh rate
  4. Add custom coins - Enter CoinGecko ID (e.g., bitcoin, ethereum)
  5. Position the widget - Drag from the header to move

Keyboard Shortcuts

  • Click & Drag - Move widget
  • โš™๏ธ - Open settings
  • โŸณ - Manual refresh
  • ๐Ÿ“Œ - Toggle always on top
  • โ€” - Minimize window

Supported Cryptocurrencies (Default)

Symbol Name Symbol Name
BTC Bitcoin SOL Solana
ETH Ethereum XRP Ripple
BNB Binance Coin DOT Polkadot
ADA Cardano DOGE Dogecoin
AVAX Avalanche LINK Chainlink
MATIC Polygon LTC Litecoin

Add any crypto by entering its CoinGecko ID!

๐Ÿ–ผ๏ธ Screenshots

Main Widget

Main Widget

Settings Panel

Settings Panel

Custom Crypto

Custom Crypto

โš™๏ธ Configuration

Update Frequencies

  • 1 second - Ultra real-time (not recommended for rate limits)
  • 5 seconds - Real-time tracking
  • 15 seconds - Balanced updates
  • 30 seconds - Default, recommended
  • 1 minute - Conservative, API-friendly

API Rate Limits

CoinGecko free API limits:

  • 10-50 requests/minute
  • Recommended: 30s+ update frequency

๐Ÿ› Troubleshooting

"Failed to fetch" error

  • Cause: CORS policy or network issue
  • Solution: Use local server (not file:// protocol)

Rate limit exceeded

  • Cause: Too many API requests
  • Solution: Increase update frequency to 1 minute

Widget not transparent

  • Cause: Electron configuration
  • Solution: Add transparent: true in BrowserWindow options

๐Ÿค Contributing

Contributions are welcome! Please follow these steps:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

๐Ÿ“ License

This project is licensed under the MIT License - see the LICENSE file for details.

๐Ÿ™ Acknowledgments

  • CoinGecko - Cryptocurrency data API
  • Google Fonts - Inter font family
  • Inspired by modern crypto tracking apps

๐Ÿ“ง Contact

๐ŸŒ Website: deskpulse.io

Project Link: https://github.com/yourusername/deskpulse-crypto-widget


โญ Star this repo if you find it useful!

Download DeskPulse

Made with โค๏ธ for the crypto community

Popular repositories Loading

  1. DeskPulse DeskPulse Public

    A sleek, transparent desktop widget for real-time cryptocurrency price tracking with customizable alerts and stunning visual effects. Built with HTML, CSS, and vanilla JavaScript.