Feature Request
For feature request, create an issue of Github.
Bugs and Debugging
Encountering issues with this app? Please follow the steps below for troubleshooting and reporting:
Flatpak
- Check the runtime log at:
~/.var/app/io.github.maniacx.BudsLink/.local/state/log/runtime.log(Note: On some distributions, the .var directory may be located elsewhere.)
- If the issue persists, create a GitHub issue. Please describe the problem in detail and attach the log file.
- Run the application from the command line and check for any log messages:
flatpak run io.github.maniacx.BudsLink
Gjs script
Verify that all required dependencies are installed. See the dependency list here
Check the log file located in the local data log directory inside the script folder.
- Run the script from the terminal/console using
gjs-consolecommand and observe any output or error messages:gjs-console -m /path/to/BudsLink/script.jsAny logs displayed
- If the problem persists, open an issue on GitHub and attach the relevant logs.
Terminating the Application
The application correctly handles cleanup during normal shutdown and when receiving SIGTERM or SIGINT signals. This includes properly terminating any pactl subprocess started by the app.
If the application is terminated using other methods (for example, kill -9), cleanup handlers will not run. In such cases, you may need to manually terminate any remaining pactl processes started by the application, if they still exist.