From 0133b61944d4eb084a33e247a76c2261d32ac4d2 Mon Sep 17 00:00:00 2001 From: JobyGitGud Date: Sat, 17 May 2025 17:25:50 -0500 Subject: [PATCH] updated readme with run directions --- README.md | 67 +++++++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 50 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index b3e775b..4e574fe 100644 --- a/README.md +++ b/README.md @@ -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