🎵 SweetTypeTone

A modern Linux application that brings mechanical keyboard sounds to your typing experience. Built with Avalonia UI and .NET 10.

✨ Features

• 🎹 Real-time Sound Playback - Keyboard sounds as you type

• 🎨 Modern UI - Beautiful gradient interface with system tray support

• 📦 Mechvibes Compatible - Import existing sound packs (OGG/WAV)

• 🔊 Volume Control - Adjustable volume with mute toggle

• ⚡ High Performance - Parallel loading, OpenAL audio engine

• 🐧 Linux Native - Built for Linux with evdev input monitoring

📥 Installation

Download AppImage (Recommended)

Download the latest AppImage from Releases:

1. Download SweetTypeTone-x.x.x-x86_64.AppImage
2. Make it executable: chmod +x SweetTypeTone-*.AppImage
3. Double-click to run
4. First run: A dialog will ask to configure permissions - click "Yes" and enter your password
5. Log out and log back in
6. Run again - Enjoy!

✨ Includes 20+ pre-installed sound packs! No installation needed. Works on Ubuntu, Fedora, Arch, and all major Linux distributions.

Download Binary Archive

Alternative installation method:

1. Download SweetTypeTone-x.x.x-linux-x64.tar.gz
2. Extract: tar -xzf SweetTypeTone-*.tar.gz
3. Run installer: ./install.sh (optional, installs to ~/.local/bin)
4. Or run directly: ./SweetTypeTone

✨ Includes 20+ pre-installed sound packs!

Build from Source

git  clone  https://github.com/amuza2/SweetTypeTone.git

cd  SweetTypeTone

# Build AppImage with bundled sound packs
./scripts/build-appimage.sh

# Or build binary archive
./scripts/build-binary.sh

# Or just build for development
dotnet  build  -c  Release
dotnet  run  --project  src/SweetTypeTone/SweetTypeTone.csproj

Requirements: .NET 10 SDK, Linux with evdev support

🎹 Bundled Sound Packs

Both AppImage and binary releases include 20+ pre-installed sound packs:

Add custom packs: Copy sound packs (OGG/WAV) to ~/.config/SweetTypeTone/CustomSoundPacks/ and click refresh.

🛠️ Tech Stack

• Avalonia UI - Cross-platform UI framework

• OpenAL - High-performance audio engine

• NVorbis - OGG Vorbis decoder

• NLayer - MP3 decoder

• Linux evdev - Native input monitoring

• .NET 10 - Modern runtime with trimming support

🤝 Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

1. Fork the repository

2. Create your feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'feat: add amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

📝 License

MIT License - see LICENSE for details.

🙏 Acknowledgments

• Inspired by Mechvibes

• Sound packs from the mechanical keyboard community

💬 Support

• 🐛 Report a Bug

• 💡 Request a Feature

• ☕ Support on Ko-fi

---

Made with ❤️ for the Linux community