Moneybird Time Tracker Stream Deck Plugin

Track your time directly from your Stream Deck with this convenient Moneybird integration.

🔧 Prerequisites

• Elgato Stream Deck
• Moneybird account
• Personal Moneybird API key

🚀 Installation

Automatic Installation

1. Download the latest .streamDeckPlugin file from the Releases page
2. Double-click the downloaded file
3. Stream Deck will prompt you to install the plugin

Manual Installation

1. Download the .streamDeckPlugin file from the Releases page
2. Open Stream Deck
3. Go to the Plugins section
4. Click "Install Plugin"
5. Select the downloaded .streamDeckPlugin file

🛠 Configuration

Obtaining Your Moneybird API Key

1. Log in to your Moneybird account
2. Go to Account Settings
3. Navigate to API Keys section
4. Create a new API key with appropriate permissions
5. Copy the generated API key

Plugin Setup

1. Add the Moneybird Time Tracker action to your Stream Deck
2. Click on the action to open the configuration
3. Enter your Moneybird API key
4. Select your administration
5. Choose a project
6. Select the user for time tracking
7. (Optional) Add a description
8. Set billable status

🕰 Using the Plugin

• Click the Stream Deck button to start/stop time tracking
• The button will show the current tracking time
• Long press or multiple clicks can be configured for additional actions

🆘 Troubleshooting

• Ensure you have the latest version of the plugin
• Verify your Moneybird API key has the correct permissions
• Check your internet connection
• Restart Stream Deck if experiencing issues

🚨 Disclaimer

This plugin is an independent third-party tool and is not officially developed, endorsed, or supported by Moneybird. It is a community-created solution to enhance your time tracking workflow.

Important Notes:

• This plugin is not an official Moneybird product
• Moneybird® is a registered trademark of Moneybird B.V.
• Use of this plugin is at your own risk
• The plugin is not affiliated with or approved by Moneybird

📝 License

MIT License

Copyright (c) 2025 Johan Kuijt

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.