Update README.md with comprehensive project documentation
- Replace default Tauri template content with detailed project description - Add comprehensive feature list and tech stack information - Include complete installation and development setup guide - Document application interface and configuration details - Add development workflow and debugging tips - Provide contributing guidelines and support information - Write documentation in English for international accessibility
This commit is contained in:
189
README.md
189
README.md
@ -1,7 +1,188 @@
|
|||||||
# Tauri + Solid + Typescript
|
# Display Ambient Light Desktop App
|
||||||
|
|
||||||
This template should help get you started developing with Tauri, Solid and Typescript in Vite.
|
A desktop application built with Tauri 2.0 for ambient light control, supporting multi-monitor screen sampling and LED strip control to create immersive ambient lighting effects.
|
||||||
|
|
||||||
## Recommended IDE Setup
|
## ✨ Features
|
||||||
|
|
||||||
- [VS Code](https://code.visualstudio.com/) + [Tauri](https://marketplace.visualstudio.com/items?itemName=tauri-apps.tauri-vscode) + [rust-analyzer](https://marketplace.visualstudio.com/items?itemName=rust-lang.rust-analyzer)
|
- 🖥️ **Multi-Monitor Support** - Automatic detection and configuration of multiple displays
|
||||||
|
- 🎨 **Real-time Screen Sampling** - High-performance screen content capture and color analysis
|
||||||
|
- 💡 **LED Strip Control** - Configurable LED strip layout and mapping support
|
||||||
|
- ⚖️ **White Balance Calibration** - Built-in white balance adjustment tool with fullscreen mode
|
||||||
|
- 🎛️ **Intuitive Configuration Interface** - Modern UI with drag-and-drop configuration support
|
||||||
|
- 🔧 **Hardware Integration** - Display brightness control and audio device management
|
||||||
|
- 📡 **Network Communication** - UDP and WebSocket communication support
|
||||||
|
|
||||||
|
## 🛠️ Tech Stack
|
||||||
|
|
||||||
|
### Frontend
|
||||||
|
|
||||||
|
- **Framework**: [Solid.js](https://solidjs.com/) - High-performance reactive UI framework
|
||||||
|
- **Build Tool**: [Vite](https://vitejs.dev/) - Fast frontend build tool
|
||||||
|
- **Styling**: [Tailwind CSS](https://tailwindcss.com/) + [DaisyUI](https://daisyui.com/) - Modern UI component library
|
||||||
|
- **Routing**: [@solidjs/router](https://github.com/solidjs/solid-router) - Client-side routing
|
||||||
|
- **Language**: TypeScript - Type-safe JavaScript
|
||||||
|
|
||||||
|
### Backend
|
||||||
|
|
||||||
|
- **Framework**: [Tauri 2.0](https://tauri.app/) - Cross-platform desktop app framework
|
||||||
|
- **Language**: Rust - High-performance systems programming language
|
||||||
|
- **Screen Capture**: [screen-capture-kit](https://crates.io/crates/screen-capture-kit) - macOS native screen capture
|
||||||
|
- **Display Control**: [ddc-hi](https://crates.io/crates/ddc-hi) - DDC/CI display control
|
||||||
|
- **Audio**: [coreaudio-rs](https://crates.io/crates/coreaudio-rs) - macOS audio system integration
|
||||||
|
- **Networking**: tokio + tokio-tungstenite - Async network communication
|
||||||
|
|
||||||
|
## 📋 System Requirements
|
||||||
|
|
||||||
|
- **Operating System**: macOS 13.0+ (primary supported platform)
|
||||||
|
- **Memory**: 4GB+ recommended
|
||||||
|
- **Graphics**: Hardware-accelerated graphics card
|
||||||
|
- **Network**: For device discovery and communication
|
||||||
|
|
||||||
|
## 🚀 Quick Start
|
||||||
|
|
||||||
|
### Prerequisites
|
||||||
|
|
||||||
|
1. **Install Rust**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
|
||||||
|
source ~/.cargo/env
|
||||||
|
```
|
||||||
|
|
||||||
|
2. **Install Node.js and pnpm**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Install Node.js (recommended using nvm)
|
||||||
|
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
|
||||||
|
nvm install node
|
||||||
|
|
||||||
|
# Install pnpm
|
||||||
|
npm install -g pnpm
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **Install Tauri CLI**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo install @tauri-apps/cli@next
|
||||||
|
```
|
||||||
|
|
||||||
|
### Development Setup
|
||||||
|
|
||||||
|
1. **Clone the project**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone <repository-url>
|
||||||
|
cd display-ambient-light/desktop
|
||||||
|
```
|
||||||
|
|
||||||
|
2. **Install dependencies**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pnpm install
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **Start development server**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pnpm tauri dev
|
||||||
|
```
|
||||||
|
|
||||||
|
### Production Build
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Build the application
|
||||||
|
pnpm tauri build
|
||||||
|
|
||||||
|
# Build artifacts are located in src-tauri/target/release/bundle/
|
||||||
|
```
|
||||||
|
|
||||||
|
## 📱 Application Interface
|
||||||
|
|
||||||
|
### Main Pages
|
||||||
|
|
||||||
|
1. **System Info** (`/info`) - Display system and hardware information
|
||||||
|
2. **Display Info** (`/displays`) - Monitor status and configuration
|
||||||
|
3. **LED Strip Configuration** (`/led-strips-configuration`) - LED strip layout and mapping configuration
|
||||||
|
4. **White Balance** (`/white-balance`) - Color calibration and white balance adjustment
|
||||||
|
|
||||||
|
### Core Features
|
||||||
|
|
||||||
|
- **Real-time Screen Preview** - WebSocket streaming of screen content
|
||||||
|
- **LED Mapping Configuration** - Visual configuration of LED strip positions and quantities
|
||||||
|
- **Color Calibration** - RGB adjustment panel with fullscreen comparison mode
|
||||||
|
- **Device Management** - Automatic discovery and management of LED control devices
|
||||||
|
|
||||||
|
## 🔧 Configuration Files
|
||||||
|
|
||||||
|
Application configuration is stored in the user directory:
|
||||||
|
|
||||||
|
```text
|
||||||
|
~/Library/Application Support/cc.ivanli.ambient-light.desktop/
|
||||||
|
├── config.toml # Main configuration file
|
||||||
|
├── led_strips.json # LED strip configuration
|
||||||
|
└── color_calibration.json # Color calibration data
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🎯 Development Guide
|
||||||
|
|
||||||
|
### Project Structure
|
||||||
|
|
||||||
|
```text
|
||||||
|
desktop/
|
||||||
|
├── src/ # Frontend source code (Solid.js)
|
||||||
|
│ ├── components/ # UI components
|
||||||
|
│ ├── stores/ # State management
|
||||||
|
│ ├── models/ # Data models
|
||||||
|
│ └── contexts/ # React Context
|
||||||
|
├── src-tauri/ # Backend source code (Rust)
|
||||||
|
│ ├── src/
|
||||||
|
│ │ ├── ambient_light/ # Ambient light control
|
||||||
|
│ │ ├── display/ # Display management
|
||||||
|
│ │ ├── rpc/ # Network communication
|
||||||
|
│ │ └── screenshot/ # Screen capture
|
||||||
|
│ └── tauri.conf.json # Tauri configuration
|
||||||
|
└── package.json # Frontend dependencies
|
||||||
|
```
|
||||||
|
|
||||||
|
### Development Workflow
|
||||||
|
|
||||||
|
1. **Frontend Development**: Modify files under `src/`, supports hot reload
|
||||||
|
2. **Backend Development**: Modify files under `src-tauri/src/`, requires dev server restart
|
||||||
|
3. **Configuration Changes**: Restart required after modifying `tauri.conf.json`
|
||||||
|
|
||||||
|
### Debugging Tips
|
||||||
|
|
||||||
|
- Use browser developer tools to debug frontend
|
||||||
|
- Use `console.log` and Rust's `println!` for debugging
|
||||||
|
- Check Tauri console output for backend logs
|
||||||
|
|
||||||
|
## 🤝 Contributing
|
||||||
|
|
||||||
|
1. Fork the project
|
||||||
|
2. Create your 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](LICENSE) file for details.
|
||||||
|
|
||||||
|
## 🔗 Related Links
|
||||||
|
|
||||||
|
- [Tauri Official Documentation](https://tauri.app/)
|
||||||
|
- [Solid.js Official Documentation](https://solidjs.com/)
|
||||||
|
- [Rust Official Documentation](https://doc.rust-lang.org/)
|
||||||
|
- [Tailwind CSS Documentation](https://tailwindcss.com/docs)
|
||||||
|
|
||||||
|
## 📞 Support
|
||||||
|
|
||||||
|
If you encounter issues or have suggestions, please:
|
||||||
|
|
||||||
|
- Create an [Issue](../../issues)
|
||||||
|
- Check the [Wiki](../../wiki) for more information
|
||||||
|
- Contact the developer
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**Note**: This application is primarily optimized for macOS platform, support for other platforms may be limited.
|
||||||
|
|||||||
Reference in New Issue
Block a user