Readme update
+31 −35 · 2 files changed
-
README.md+30 −34 -
paintstorm-setup/README.md+1 −1
@@ -4,24 +4,24 @@ A complete setup script to run Paintstorm Studio v2.50 in an Ubuntu 20.04 distro ## Features -✅ **Complete Installation** + **Complete Installation** - Automated Ubuntu 20.04 container creation - GLEW 1.13.0 built from source - All required dependencies installed - Font crash prevention configured -✅ **Tablet Support** (Native HID - RECOMMENDED) + **Tablet Support** (Native HID - RECOMMENDED) - Full pressure sensitivity (0-8191 levels) - Tilt support (X/Y angles) - **Hidraw device passthrough** for pressure/tilt data - Button mapping to keyboard shortcuts - No OpenTabletDriver required! -✅ **Hardware Acceleration** + **Hardware Acceleration** - Automatic NVIDIA GPU detection and support - OpenGL acceleration -✅ **Easy Management** + **Easy Management** - Desktop launcher integration - Management script for maintenance - Configuration-based button mapping @@ -63,7 +63,7 @@ sudo pacman -S xbindkeys xdotool ## Tablet Pressure & Tilt Support -### ✅ Using Native HID (RECOMMENDED) +### Using Native HID (RECOMMENDED) Native Linux HID drivers provide full pressure and tilt support without any configuration: @@ -73,11 +73,11 @@ Native Linux HID drivers provide full pressure and tilt support without any conf ``` **What you get:** -- ✅ Full pressure sensitivity (0-8191 levels) -- ✅ Tilt support (X/Y angles) -- ✅ Stable, reliable operation -- ✅ No mouse freezing issues -- ✅ Works every time +- Full pressure sensitivity (0-8191 levels) +- Tilt support (X/Y angles) +- Stable, reliable operation +- No mouse freezing issues +- Works every time ### Configure Tablet Buttons @@ -120,9 +120,9 @@ For detailed tablet troubleshooting, see [docs/TABLET-PRESSURE-FIX.md](docs/TABL ``` This will verify: -- ✅ Hidraw devices on host -- ✅ Hidraw devices in container -- ✅ Input device configuration +- Hidraw devices on host +- Hidraw devices in container +- Input device configuration ## Project Structure @@ -132,14 +132,14 @@ paintstorm-distrobox-legacy/ ├── README.md # This file ├── test-tablet-pressure.sh # General tablet diagnostic │ -├── paintstorm-setup/ # 🎨 Paintstorm installation +├── paintstorm-setup/ # Paintstorm installation │ ├── README.md # Installation guide │ ├── paintstorm-install-distrobox.sh # Main installer (run this) │ ├── container-setup.sh # Container configuration │ ├── paintstorm-launcher.sh # App launcher template │ └── paintstorm-manage.sh # Container management │ -├── native-hid-tablet-mapping/ # ✅ RECOMMENDED: Button mapping +├── native-hid-tablet-mapping/ # RECOMMENDED: Button mapping │ ├── README.md # Setup guide │ ├── tablet-button-config.conf # Your button mappings (edit this) │ ├── apply-button-mappings.sh # Apply configuration @@ -149,11 +149,7 @@ paintstorm-distrobox-legacy/ │ ├── detect-tablet-buttons.sh # Comprehensive detection │ └── configure-tablet-buttons.sh # Legacy manual config │ -├── otd-diagnostics/ # ❌ NOT RECOMMENDED: OTD troubleshooting -│ ├── README.md # Why OTD doesn't work -│ └── (various diagnostic scripts) # For debugging OTD issues -│ -└── docs/ # 📚 Documentation +└── docs/ # Documentation └── TABLET-PRESSURE-FIX.md # Detailed tablet troubleshooting ``` @@ -185,17 +181,17 @@ See [native-hid-tablet-mapping/README.md](native-hid-tablet-mapping/README.md) f ## Version History -### v2.5 (2024-01-24) - **CURRENT** -- ✅ Reorganized into native HID (recommended) and OTD diagnostics (not recommended) -- ✅ Added configuration-based button mapping system -- ✅ Created comprehensive native HID setup guide -- ✅ Documented why OTD doesn't work with Paintstorm -- ✅ Cleaned up script organization +### v2.5 - **CURRENT** +- Reorganized into native HID (recommended) and OTD diagnostics (not recommended) +- Added configuration-based button mapping system +- Created comprehensive native HID setup guide +- Documented why OTD doesn't work with Paintstorm +- Cleaned up script organization -### v2.4 (2024-01-23) -- ✅ Added hidraw device detection and passthrough -- ✅ Created tablet diagnostic scripts -- ✅ Extensive OTD troubleshooting (determined OTD not viable) +### v2.4 +- Added hidraw device detection and passthrough +- Created tablet diagnostic scripts +- Extensive OTD troubleshooting (determined OTD not viable) ### v2.3 - Pen tablet support with event device passthrough @@ -211,9 +207,9 @@ See [native-hid-tablet-mapping/README.md](native-hid-tablet-mapping/README.md) f **For Huion tablets (and likely other brands):** -1. ✅ **Use native HID** (no OTD) -2. ✅ **Configure buttons** with xbindkeys (see `native-hid-tablet-mapping/`) -3. ✅ **Enjoy full pressure and tilt** without any hassle +1. **Use native HID** (no OTD) +2. **Configure buttons** with xbindkeys (see `native-hid-tablet-mapping/`) +3. **Enjoy full pressure and tilt** without any hassle This provides the best experience with Paintstorm in distrobox. @@ -233,6 +229,6 @@ This setup script is provided as-is for use with legally obtained copies of Pain --- -**Happy painting! 🎨** +**Happy painting! ** **For tablet button setup, go to:** `native-hid-tablet-mapping/` @@ -8,7 +8,7 @@ This folder contains the core scripts for installing and managing Paintstorm Stu - **`paintstorm-install-distrobox.sh`** - Main installation script (run this first) - Creates Ubuntu 20.04 distrobox container - Downloads Paintstorm v2.50 automatically (if not found locally) - - Builds GLEW 1.13.0 from source + - Builds GLEW 1.13.0 from source. You can grab it [here](https://sourceforge.net/projects/glew/) - Installs all dependencies - Configures tablet support (hidraw passthrough) - Creates desktop launcher and icon