Skip to content
This repository has been archived by the owner on Jun 6, 2024. It is now read-only.

Commit

Permalink
Merge pull request #21 from frunika/master
Browse files Browse the repository at this point in the history
  • Loading branch information
tobimori authored Apr 6, 2021
2 parents 73ee1ae + 897c0c7 commit b466a60
Show file tree
Hide file tree
Showing 3 changed files with 21 additions and 10 deletions.
31 changes: 21 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@
<img src="resources/readme/GitHubBanner.png" alt="Toggl Track + Elgato Stream Deck" />
</a>
</p>

<p align="center">
<a href="#">
<img src="https://img.shields.io/badge/macOS-✓-success?logo=apple&style=flat-square&logoColor=white" alt="macOS supported" />
Expand All @@ -24,26 +25,36 @@
</a>
</p>

<p align="center">
Hassle-free time tracking using the <a href="https://www.elgato.com/en/gaming/stream-deck">Elgato Stream Deck</a>
and <a href="https://toggl.com/track/">Toggl Track</a>.
</p>

___

# ✏️ Setup
# Hassle-free time tracking using [Elgato Stream Deck](https://www.elgato.com/en/gaming/stream-deck) and [Toggl Track](https://toggl.com/track/)

## ✏️ Setup

![](resources/readme/PropertyInspector.png)
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](resources/readme/PropertyInspector.png)

* **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](https://track.toggl.com/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.
* **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](resources/readme/StreamDeckScreenshot.png)

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
## 📞 Help

Feel free to ask your questions on [my Discord Server](https://discord.gg/YWy3UAy). Please use GitHub Issues for reporting bugs and requesting new features.

# 📄 License
## 📄 License

streamdeck-toggl is licensed under the [MIT License](LICENSE).

## Known Issues

* Changing the *Button Label* wont change the *Title* immediately. Restart Stream Deck.
Binary file modified resources/readme/PropertyInspector.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added resources/readme/StreamDeckScreenshot.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit b466a60

Please sign in to comment.