|
| 1 | +# ScreenKey v1.0.0 Release |
| 2 | + |
| 3 | +## Release Steps |
| 4 | + |
| 5 | +### 1. Commit all changes |
| 6 | + |
| 7 | +```bash |
| 8 | +git add . |
| 9 | +git commit -m "Release v1.0.0" |
| 10 | +git push origin master |
| 11 | +``` |
| 12 | + |
| 13 | +### 2. Create and push the release tag |
| 14 | + |
| 15 | +```bash |
| 16 | +git tag v1.0.0 |
| 17 | +git push origin v1.0.0 |
| 18 | +``` |
| 19 | + |
| 20 | +### 3. GitHub Actions will automatically: |
| 21 | + |
| 22 | +- Build for Linux (AppImage, .deb) |
| 23 | +- Build for macOS (Intel + Apple Silicon DMG) |
| 24 | +- Build for Windows (MSI installer) |
| 25 | +- Create a GitHub Release with all binaries |
| 26 | + |
| 27 | +### 4. Monitor the build |
| 28 | + |
| 29 | +Visit: https://github.com/rusmanplatd/screenkey/actions |
| 30 | + |
| 31 | +### 5. After build completes |
| 32 | + |
| 33 | +- Go to: https://github.com/rusmanplatd/screenkey/releases |
| 34 | +- The draft release will be created with all installers attached |
| 35 | +- Edit the release notes if needed |
| 36 | +- Publish the release |
| 37 | + |
| 38 | +## What Changed in v1.0.0 |
| 39 | + |
| 40 | +See [CHANGELOG.md](CHANGELOG.md) for full details. |
| 41 | + |
| 42 | +### Highlights: |
| 43 | + |
| 44 | +- ✨ Three layout modes (Vertical, Horizontal, Wrapped) |
| 45 | +- 🎨 Six predefined themes + custom theme creator |
| 46 | +- ⚙️ Comprehensive settings panel |
| 47 | +- 🖱️ Draggable window with minimize/close controls |
| 48 | +- 📏 Configurable font size and opacity |
| 49 | +- ⏱️ Auto-hide duration for keys |
| 50 | +- 🔝 Always-on-top with proper z-index |
| 51 | +- 🎯 Smart auto-scroll |
| 52 | +- 🖼️ Professional app icon |
| 53 | +- 🌐 Cross-platform builds (Linux, macOS, Windows) |
| 54 | + |
| 55 | +## Platform Notes |
| 56 | + |
| 57 | +### Linux |
| 58 | + |
| 59 | +- **Full functionality** with global keyboard capture |
| 60 | +- Requires `sudo` or user in `input` group |
| 61 | +- Supports both X11 and Wayland |
| 62 | + |
| 63 | +### macOS & Windows |
| 64 | + |
| 65 | +- **Window and UI only** - keyboard capture not available |
| 66 | +- App will launch and display correctly |
| 67 | +- Shows warning message about Linux-only keyboard capture |
| 68 | + |
| 69 | +## Installation |
| 70 | + |
| 71 | +### Linux (Ubuntu/Debian) |
| 72 | + |
| 73 | +```bash |
| 74 | +# Download .deb from releases |
| 75 | +sudo dpkg -i screenkey-app_1.0.0_amd64.deb |
| 76 | + |
| 77 | +# Or use AppImage |
| 78 | +chmod +x ScreenKey_1.0.0_amd64.AppImage |
| 79 | +sudo ./ScreenKey_1.0.0_amd64.AppImage |
| 80 | +``` |
| 81 | + |
| 82 | +### macOS |
| 83 | + |
| 84 | +```bash |
| 85 | +# Download and open DMG |
| 86 | +# Drag to Applications folder |
| 87 | +# Right-click > Open (first time only) |
| 88 | +``` |
| 89 | + |
| 90 | +### Windows |
| 91 | + |
| 92 | +```bash |
| 93 | +# Download and run MSI installer |
| 94 | +# Follow installation wizard |
| 95 | +``` |
| 96 | + |
| 97 | +## Known Issues |
| 98 | + |
| 99 | +- Keyboard capture only works on Linux (by design) |
| 100 | +- macOS and Windows versions are UI-only |
| 101 | + |
| 102 | +## Future Plans |
| 103 | + |
| 104 | +- Investigate keyboard capture for macOS/Windows |
| 105 | +- Add recording/export functionality |
| 106 | +- Custom key filtering |
| 107 | +- More themes and customization options |
0 commit comments