updated readme with run directions

This commit is contained in:
2025-05-17 17:25:50 -05:00
parent 20592954f7
commit 0133b61944
+50 -17
View File
@@ -11,6 +11,7 @@ A cross-platform application for customizing your cursor with gameified logic.
- System tray integration with context menu
- Global hotkey support
- Steam integration for item drops
- Tauri-based frontend with React
## Project Structure
@@ -60,6 +61,8 @@ src/
- Rust 1.70.0 or later
- Cargo
- Node.js 16.0.0 or later
- npm 7.0.0 or later
- Platform-specific dependencies:
- Windows: None (fully supported)
- macOS: Development in progress
@@ -68,41 +71,49 @@ src/
### Dependencies
The application uses the following major dependencies:
- iced 0.13.1 - GUI framework
- tray-icon 0.20.1 - System tray functionality
- Tauri 1.6.0 - Cross-platform framework
- React - Frontend framework
- image 0.24.7 - Image processing
- global-hotkey 0.4.2 - Global hotkey registration
- steamworks 0.11.0 - Steam integration
- winapi 0.3.9 - Windows API bindings
- once_cell 1.19.0 - Lazy initialization
### Build Commands
```bash
# Debug build
cargo build
# Navigate to the frontend directory
cd frontend
# Release build
cargo build --release
# Install npm dependencies
npm install
# Run in development mode
npm run tauri dev
# Build for production
npm run tauri build
```
## Usage
1. Place your cursor PNG files in the `assets` directory (PNG format only)
2. Run the application using `cargo run` or the compiled executable
3. The application will load all PNG files from the assets directory
4. Select a cursor from the list in the UI
5. The application will replace your system cursor with the selected image
6. When closing the window, the application minimizes to the system tray
7. To fully exit, use the system tray menu or press the exit hotkey
1. Make sure you have Node.js and npm installed
2. Navigate to the frontend directory: `cd frontend`
3. Install dependencies if you haven't already: `npm install`
4. Run the application in development mode: `npm run tauri dev`
5. The application will start with a React frontend and Rust backend
6. Use the UI to browse and select cursors
7. The application will replace your system cursor with the selected image
8. To exit, use the "Quit" button in the application or from the system tray
### Custom Cursors
The application comes with two sample cursors in the `assets` directory:
The application comes with sample cursors:
- `default.png` - A simple default cursor
- `icon.png` - An icon cursor
- `red.png` - A red-colored cursor
To add your own cursors:
1. Create PNG images with transparent backgrounds
2. Place them in the `assets` directory
2. Place them in the `frontend/src/cursors` directory
3. Restart the application to load the new cursors
4. The cursor name in the UI will be derived from the filename
@@ -138,6 +149,27 @@ The application includes integration with the Steam API for future gameified fea
- Item drop functionality is implemented but not yet active
- Steam must be running for this functionality to work
## Project Structure (Tauri Version)
```
frontend/
├── src/ # React frontend code
│ ├── App.jsx # Main React component
│ ├── components/ # UI components
│ └── cursors/ # Cursor image files
├── src-tauri/ # Rust backend code
│ ├── src/ # Rust source code
│ │ ├── lib.rs # Main library code
│ │ ├── main.rs # Application entry point
│ │ └── platform/ # Platform-specific code
│ │ ├── mod.rs # Platform module exports
│ │ ├── windows/ # Windows-specific code
│ │ ├── macos/ # macOS-specific code
│ │ └── linux/ # Linux-specific code
│ └── Cargo.toml # Rust dependencies
└── package.json # npm dependencies
```
## Contributing
Contributions to Cursor Rush are welcome! Here are some ways you can contribute:
@@ -147,6 +179,7 @@ Contributions to Cursor Rush are welcome! Here are some ways you can contribute:
- Submit pull requests with bug fixes or new features
- Help with documentation
- Contribute to macOS and Linux platform support
- Improve the Tauri integration
## License