Git Product home page Git Product logo

streamdeck-toggl's Introduction

โš ๏ธ API V8 Depreciation

You may have received an email from toggl, stating you are using the v8 Api, which this plugin previously used. As per #41, this issue has been fixed. Unfortunatley, these changes cannot be published to the elgato store. To workaround this issue conduct the following:

  • Download the zip file from the newest release.
  • Extract it and double-click the .streamDeckPlugin file to install it.

โธ Development ended - open to handover project

Unfortunately, I am lacking time and energy to actively uphold development of this plugin. It still works with its bugs and quirks, but I will archive the plugin as-is for the time being. If anyone would like to take over and continue the development of this plugin, I'd be very happy - please get in touch.

Toggl Track + Elgato Stream Deck

macOS supported Windows supported Follow @tobimori on Twitter Meet on Discord Total Downloads Total Time Tracked Working On streamdeck-toggl


Hassle-free time tracking using Elgato Stream Deck and Toggl Track

โœ๏ธ Setup

Just search for the Action "Toggl" within the Stream Deck app and install it. There is a button called "Toggl" available in section "Custom".

PropertyInspector

  • Title is a default Stream Deck property available for every button in Stream Deck. You should leave it empty (see Button Label).
  • API Token is your private API Token you can get from your Toggl profile. This Token is handled like a password. Don't share it. Required.
  • Button Label is used instead of Title. If the tracker isn't running, the Label is shown on the button. If the tracker is running the elapsed time is shown additionally. If Title is set, it will override Button Label.
  • Entry Name describes the activity you want to report. It is not required but strongly recommended.
  • Workspace is your workspace you start the time entries in. Required.
  • Project is the project you want to assign the task to. Leave blank for no project. New projects can be added in Toggl.
  • Billable sets Toggl's billable flag (for Toggl paid plans only).

StreamDeckScreenshot

Just press any Toggl Button to start tracking time. The button should indicate tracking by turning red and showing the current tracking time (if no Title is set). The status of the button is defined by workspace, project and entry name. If you setup two identical buttons (even on different Stream Deck profiles), both button indicate the same. If you start or stop your timer using the Toggl app (web, desktop, mobile) Toggl for Stream Deck will follow by changing the status.

๐Ÿ“ž Help

Feel free to ask your questions on my Discord Server. Please use GitHub Issues for reporting bugs and requesting new features.

๐Ÿ“„ License

streamdeck-toggl is licensed under the MIT License.

Known Issues

  • Changing the Button Label wont change the Title immediately. Restart Stream Deck.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.