ZimaOS Client - Chrome Extension

A Chrome browser extension for managing and quickly accessing ZimaOS systems.

Features

• 🔧 Configuration Management: Easily configure ZimaOS IP address, username, and password
• 🔐 Auto Login: Integrated ZimaOS login API with automatic token acquisition and management
• 🔄 Token Management: Automatically refresh expired access tokens without re-login
• 🏠 Quick Access: One-click access to ZimaOS homepage
• 📱 App Shortcuts: Quick access to commonly used ZimaOS applications
• 🔄 Connection Status: Real-time display of ZimaOS connection status
• ⚙️ Settings Management: Modify connection configuration anytime
• 🐛 Debug Features: Built-in debug logging for development and troubleshooting

Installation

Developer Mode Installation (Recommended for Testing)

• Download or clone this project locally
• Open Chrome browser and navigate to the extensions management page:

• Method 1: Enter chrome://extensions/ in the address bar

• Method 2: Click the three-dot menu in the top right → More tools → Extensions
• Enable "Developer mode" in the top right corner
• Click "Load unpacked"
• Select the project folder
• Extension installation complete!

Usage Instructions

Initial Configuration

• After installing the extension, click the ZimaOS icon in the browser toolbar
• First-time use will show a configuration prompt, click "Start Configuration"
• Fill in the following information:

• ZimaOS Address: Your ZimaOS system IP address and port (e.g., 192.168.1.100:8080)

• Username: ZimaOS login username

• Password: ZimaOS login password
• Click "Test Connection" to verify the configuration is correct
• Click "Save Configuration" to complete setup

Daily Usage

• Quick Access: Click the extension icon, then click "Open ZimaOS" to directly access the system homepage
• App Shortcuts: Click app icons in the extension popup to quickly open corresponding features
• View Status: The extension displays current ZimaOS connection status (online/offline)
• Modify Configuration: Click the settings button or "Modify Configuration" to update connection information

Available App Shortcuts

• 📁 File Manager: Access ZimaOS file manager
• 🎵 Media Center: Open media playback and management
• 🐳 Docker: Manage Docker containers
• ⚙️ System Settings: Access system configuration
• 💻 Terminal: Open web terminal
• 📊 System Monitor: View system performance monitoring

Debug Guide

Development Environment Setup

• Ensure the extension is installed following the above method
• Find "ZimaOS Client" on the Chrome extensions page
• Click "Details" to enter the extension details page

Debugging Methods

1. View Console Logs

Popup Page Debugging:

• Right-click the extension icon and select "Inspect popup"
• View logs in the Console tab of developer tools

• Click "Extension options" on the extension details page
• Press F12 on the configuration page to open developer tools

• Click "Inspect views" next to "service worker" on the extension details page
• View background script logs

2. Common Issue Troubleshooting

Connection Test Failed:

• Check if ZimaOS address format is correct
• Confirm ZimaOS system is running
• Check network connection
• Look for CORS errors in browser console

• Check if manifest.json syntax is correct
• Confirm all referenced file paths exist
• Check error messages on Chrome extensions page

• Check if CSS file paths are correct
• Confirm files exist in styles directory
• Use developer tools to check CSS loading

3. Reload Extension

After modifying code, you need to reload the extension:

• Go to chrome://extensions/
• Find the "Zima Nodes" extension
• Click the refresh button (🔄)
• Re-test functionality

File Structure

zima-client/
├── manifest.json          # Extension configuration file
├── popup.html             # Main popup page
├── options.html           # Configuration page
├── background.js          # Background script
├── scripts/
│   ├── popup.js          # Popup page script
│   └── options.js        # Configuration page script
├── styles/
│   ├── popup.css         # Popup page styles
│   └── options.css       # Configuration page styles
├── icons/
│   └── icon.svg          # Extension icon
└── README.md             # Documentation

Technical Details

• Manifest Version: 3 (Latest version)
• Permissions: storage (store configuration), activeTab (open tabs)
• Storage: Uses Chrome Storage API for synchronized configuration storage
• Compatibility: Chrome 88+

Important Notes

• The extension uses Chrome Storage API to store configuration information, data will sync across devices logged into the same Google account
• Passwords are stored locally in plain text, please ensure device security
• Connection testing uses simple HTTP requests, which may be limited by CORS policies
• Recommended for use in LAN environments to ensure ZimaOS system security

License

Apache License 2.0