Initial commit: Razer Battery Widget

Author: LeonardoVidolin

.gitignore

@@ -0,0 +1,4 @@
+node_modules/
+dist/
+*.log
+.DS_Store

GIT_SETUP.md

@@ -0,0 +1,83 @@
+# Git setup for Razer Battery Widget
+
+Follow these steps in **Command Prompt** or **PowerShell**. Replace placeholders with your details.
+
+---
+
+## 1. Check if Git is installed
+
+```bat
+git --version
+```
+
+If you see a version (e.g. `git version 2.43.0`), Git is installed. If you get an error, install Git from https://git-scm.com/download/win and run the installer, then open a new terminal.
+
+---
+
+## 2. Configure your identity (one-time per PC)
+
+Git needs your name and email for every commit. Set them globally:
+
+```bat
+git config --global user.name "Your Name"
+git config --global user.email "your.email@example.com"
+```
+
+Use the **same email** as your GitHub account if you plan to push to GitHub.
+
+**Check that it worked:**
+
+```bat
+git config --global user.name
+git config --global user.email
+```
+
+---
+
+## 3. Optional: default branch name
+
+```bat
+git config --global init.defaultBranch main
+```
+
+---
+
+## 4. Turn this project into a Git repo and push to GitHub
+
+Run these from the **project folder** (e.g. `d:\Cursos\Battery_widget`).
+
+**Replace `YOUR_USERNAME`** with your GitHub username. Create the repo on GitHub first (New repository, name it e.g. `razer-battery-widget`, leave README/.gitignore/license unchecked).
+
+```bat
+cd /d d:\Cursos\Battery_widget
+
+git init
+git add .
+git status
+git commit -m "Initial commit: Razer Battery Widget"
+git branch -M main
+git remote add origin https://github.com/YOUR_USERNAME/razer-battery-widget.git
+git push -u origin main
+```
+
+- **`git status`** — Shows what will be committed. You should see no `node_modules` or `dist` (they’re in `.gitignore`).
+- **GitHub login:** On first `git push`, Windows may open a browser or ask for credentials. Sign in with your GitHub account. If it asks for a password, use a **Personal Access Token** (GitHub → Settings → Developer settings → Personal access tokens → Generate new token).
+
+---
+
+## 5. After the first push
+
+- Edit **README.md** and **package.json**: replace `YOUR_USERNAME` with your real GitHub username so the “Download” and repo links work.
+- Create a **Release** on GitHub and upload the installer from `dist\` so people can download it.
+
+---
+
+## Quick reference
+
+| Task              | Command |
+|-------------------|--------|
+| See status        | `git status` |
+| Add all changes   | `git add .` |
+| Commit            | `git commit -m "Your message"` |
+| Push to GitHub    | `git push` |
+| Pull from GitHub  | `git pull` |

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Razer Battery Widget contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,103 @@
+# Razer Battery Widget
+
+A small desktop widget that shows battery level for your Razer wireless gear (headphones, keyboard, mouse) with circular indicators and a charging (lightning) icon when applicable. Styled with Razer’s dark theme and green accents.
+
+## Download
+
+**[→ Latest release (installer)](https://github.com/YOUR_USERNAME/razer-battery-widget/releases/latest)** — Download the `.exe` installer, run it, and you’re done. Requires [Razer Synapse 3](https://www.razer.com/synapse-3) or [Razer Synapse 4](https://www.razer.com/synapse) to be running.
+
+*(Replace `YOUR_USERNAME` with your GitHub username after you create the repo and your first release.)*
+
+## How it works
+
+Like [razer-taskbar](https://github.com/sanraith/razer-taskbar), this app reads battery data from **Razer Synapse** log files—no USB or driver needed. You must have **Razer Synapse 3** or **Razer Synapse 4** running.
+
+- **Synapse 3:** `%LOCALAPPDATA%\Razer\Synapse3\Log\Razer Synapse 3.log`
+- **Synapse 4:** `%LOCALAPPDATA%\Razer\RazerAppEngine\User Data\Logs\systray_systrayv2*.log`
+
+## Requirements
+
+- Windows (tested on 10 & 11)
+- Razer Synapse 3 or 4 running in the background
+- Node.js (for running from source or building the .exe)
+
+## Run from source
+
+```bash
+npm install
+npm start
+```
+
+The widget appears as a floating window. Drag the background to move it. Close the window to minimize to the system tray; double‑click the tray icon or use **Show Widget** in the tray menu to open it again.
+
+## Start with Windows
+
+- Right‑click the tray icon → **Start with Windows** (checked by default).
+- When enabled, the widget will start automatically when you log in.
+
+## Build an installer (.exe)
+
+```bash
+npm install
+npm run build
+```
+
+The installer is created in the `dist/` folder. Run it to install Razer Battery Widget; you can choose the install location and create a desktop shortcut. After installation, enable **Start with Windows** in the tray menu if you want it to launch at login.
+
+## Device mapping
+
+Devices are matched to slots by name. If a device isn’t recognized, it is still shown in the first available slot (headphones, then keyboard, then mouse).
+
+- **Headphones:** headset, headphone, BlackShark, Kraken, Barracuda, Nari, etc.
+- **Keyboard:** keyboard, BlackWidow, Huntsman, Ornata, Cynosa, etc.
+- **Mouse:** mouse, DeathAdder, Viper, Basilisk, Mamba, Naga, Orochi, Cobra, Pro Click, etc.
+
+You can extend the keywords in `renderer.js` if needed.
+
+## Tray icon
+
+The system tray uses `assets/tray-icon.png` (a 32×32 Razer-green battery icon). To regenerate it:
+
+```bash
+npm run tray-icon
+```
+
+## Publishing on GitHub
+
+### 1. Create the repository and push
+
+1. On GitHub, click **New repository**. Name it (e.g. `razer-battery-widget`). Do **not** add a README, .gitignore, or license.
+2. In your project folder, run (replace `YOUR_USERNAME` with your GitHub username):
+
+   ```bash
+   git init
+   git add .
+   git commit -m "Initial commit: Razer Battery Widget"
+   git branch -M main
+   git remote add origin https://github.com/YOUR_USERNAME/razer-battery-widget.git
+   git push -u origin main
+   ```
+
+### 2. Optional: repo description and topics
+
+In the repo **Settings → General**, set a short description and topics (e.g. `razer`, `battery`, `electron`, `windows`, `synapse`).
+
+### 3. Publish a release (so others can download the installer)
+
+1. **Build the installer:**
+
+   ```bash
+   npm run build
+   ```
+
+2. **Create a release on GitHub:**
+   - Open your repo → **Releases** → **Create a new release**.
+   - **Choose a tag:** e.g. `v1.0.0` (create new tag).
+   - **Release title:** e.g. `v1.0.0`.
+   - **Description:** e.g. “First release. Windows installer for Razer Battery Widget.”
+   - **Attach the installer:** drag and drop the file from `dist/` — it’s named like **Razer Battery Widget Setup 1.0.0.exe**.
+   - Click **Publish release**.
+
+3. **Update the Download link** in this README: replace `YOUR_USERNAME` in the “Latest release” link with your GitHub username so the link points to your repo.
+
+After that, the **Download** section at the top will point to your latest release and users can get the installer from there.

assets/tray-icon.png

@@ -0,0 +1,16 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <meta http-equiv="Content-Security-Policy" content="default-src 'self'; style-src 'self' 'unsafe-inline'" />
+  <title>Razer Battery Widget</title>
+  <link rel="stylesheet" href="styles.css" />
+</head>
+<body>
+  <div class="widget">
+    <div class="devices" id="devices"></div>
+  </div>
+  <script src="renderer.js"></script>
+</body>
+</html>

index.html

@@ -0,0 +1,163 @@
+const { app, BrowserWindow, ipcMain, Tray, Menu, nativeImage } = require('electron');
+const path = require('path');
+const fs = require('fs');
+const { RazerWatcher } = require('./watcher/razer_watcher');
+
+let mainWindow = null;
+let razerWatcher = null;
+let tray = null;
+let isQuitting = false;
+
+const SETTINGS_PATH = path.join(app.getPath('userData'), 'settings.json');
+
+function loadSettings() {
+  try {
+    const data = fs.readFileSync(SETTINGS_PATH, 'utf8');
+    return { ...defaultSettings(), ...JSON.parse(data) };
+  } catch (_) {
+    return defaultSettings();
+  }
+}
+
+function defaultSettings() {
+  return { openAtLogin: true, alwaysOnTop: true };
+}
+
+function saveSettings(settings) {
+  try {
+    fs.mkdirSync(path.dirname(SETTINGS_PATH), { recursive: true });
+    fs.writeFileSync(SETTINGS_PATH, JSON.stringify(settings, null, 2), 'utf8');
+  } catch (e) {
+    console.warn('Could not save settings:', e.message);
+  }
+}
+
+function createWindow() {
+  if (mainWindow && !mainWindow.isDestroyed()) {
+    mainWindow.show();
+    mainWindow.focus();
+    return;
+  }
+
+  const settings = loadSettings();
+  mainWindow = new BrowserWindow({
+    width: 440,
+    height: 200,
+    frame: false,
+    transparent: true,
+    resizable: false,
+    alwaysOnTop: settings.alwaysOnTop !== false,
+    skipTaskbar: true,
+    webPreferences: {
+      nodeIntegration: false,
+      contextIsolation: true,
+      preload: path.join(__dirname, 'preload.js'),
+    },
+  });
+
+  mainWindow.loadFile('index.html');
+  mainWindow.setIgnoreMouseEvents(false);
+  mainWindow.setAlwaysOnTop(settings.alwaysOnTop !== false);
+  mainWindow.on('close', (e) => {
+    if (!isQuitting) {
+      e.preventDefault();
+      mainWindow.hide();
+    }
+  });
+}
+
+function createTray() {
+  const iconPath = path.join(__dirname, 'assets', 'tray-icon.png');
+  let icon = null;
+  try {
+    const buf = fs.readFileSync(iconPath);
+    if (buf && buf.length > 0) {
+      icon = nativeImage.createFromBuffer(buf);
+      if (!icon.isEmpty() && process.platform === 'win32') {
+        icon = icon.resize({ width: 16, height: 16 });
+      }
+    }
+  } catch (_) {}
+  if (!icon || icon.isEmpty()) icon = nativeImage.createEmpty();
+  tray = new Tray(icon);
+  tray.setToolTip('Razer Battery Widget');
+  tray.on('double-click', () => createWindow());
+  updateTrayMenu();
+}
+
+function updateTrayMenu() {
+  const settings = loadSettings();
+  const menu = Menu.buildFromTemplate([
+    { label: 'Show Widget', type: 'normal', click: () => createWindow() },
+    { type: 'separator' },
+    {
+      label: 'Start with Windows',
+      type: 'checkbox',
+      checked: settings.openAtLogin,
+      click: (item) => {
+        const next = { ...loadSettings(), openAtLogin: item.checked };
+        saveSettings(next);
+        app.setLoginItemSettings({ openAtLogin: next.openAtLogin });
+      },
+    },
+    {
+      label: 'Always on top',
+      type: 'checkbox',
+      checked: settings.alwaysOnTop !== false,
+      click: (item) => {
+        const next = { ...loadSettings(), alwaysOnTop: item.checked };
+        saveSettings(next);
+        if (mainWindow && !mainWindow.isDestroyed()) mainWindow.setAlwaysOnTop(next.alwaysOnTop);
+      },
+    },
+    { type: 'separator' },
+    { label: 'Quit', type: 'normal', click: () => { isQuitting = true; app.quit(); } },
+  ]);
+  tray.setContextMenu(menu);
+}
+
+app.whenReady().then(() => {
+  const settings = loadSettings();
+  app.setLoginItemSettings({ openAtLogin: settings.openAtLogin });
+
+  razerWatcher = new RazerWatcher((devices) => {
+    if (mainWindow && !mainWindow.isDestroyed()) {
+      const list = Array.from(devices.values()).filter((d) => d.isConnected);
+      mainWindow.webContents.send('devices-update', list);
+    }
+  });
+  razerWatcher.initialize();
+  razerWatcher.start();
+
+  createTray();
+  createWindow();
+});
+
+app.on('window-all-closed', (e) => {
+  if (!isQuitting) {
+    e.preventDefault();
+    if (mainWindow && !mainWindow.isDestroyed()) mainWindow.hide();
+  }
+});
+
+app.on('activate', () => {
+  createWindow();
+});
+
+app.on('before-quit', () => {
+  isQuitting = true;
+  if (tray) try { tray.destroy(); tray = null; } catch (_) {}
+  if (razerWatcher) razerWatcher.stop();
+  razerWatcher = null;
+  if (mainWindow && !mainWindow.isDestroyed()) mainWindow.destroy();
+  mainWindow = null;
+});
+
+ipcMain.handle('get-devices', () => (razerWatcher ? razerWatcher.listDevices() : []));
+ipcMain.handle('get-settings', () => loadSettings());
+ipcMain.handle('set-open-at-login', (_, value) => {
+  const settings = loadSettings();
+  settings.openAtLogin = !!value;
+  saveSettings(settings);
+  app.setLoginItemSettings({ openAtLogin: settings.openAtLogin });
+});