Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hideoo/alfred-workflow-tools
Collection of Go tools for Alfred Workflows
https://github.com/hideoo/alfred-workflow-tools
alfred follows go live tools twitch workflow
Last synced: 24 days ago
JSON representation
Collection of Go tools for Alfred Workflows
- Host: GitHub
- URL: https://github.com/hideoo/alfred-workflow-tools
- Owner: HiDeoo
- License: mit
- Created: 2021-06-22T08:47:02.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-02-16T15:38:04.000Z (11 months ago)
- Last Synced: 2024-10-09T00:41:39.795Z (3 months ago)
- Topics: alfred, follows, go, live, tools, twitch, workflow
- Language: Go
- Homepage:
- Size: 112 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
alfred-workflow-tools 🧰
`alfred-workflow-tools` is a collection of Go tools that should be invoked by [Alfred](https://www.alfredapp.com/) in [a workflow](https://www.alfredapp.com/help/workflows/).
The results are returned using the [Alfred Script Filter JSON Format](https://www.alfredapp.com/help/workflows/inputs/script-filter/json/) so they can automatically be consumed by a workflow.
## Twitch
`cmd/twitch` fetches Follows (or only Live Follows) for a specific [Twitch](https://twitch.tv) User or a list of Live Streams for a specific Game (and optionally in a specific Language).
### Usage
`cmd/twitch` can be executed in a [Run Script Action](https://www.alfredapp.com/help/workflows/actions/run-script/) to return Twitch Follows:
```shell
$ twitch
{
"items": [
{
"title": "Streamer 1",
"subtitle": "Science & Technology - 8625 viewers - Coding things",
"arg": "https://www.twitch.tv/streamer1"
},
{
"title": "Streamer 2",
"subtitle": "Just Chatting - 2811 viewers - Chatting about things",
"arg": "https://www.twitch.tv/streamer2"
},
…
]
}
```
You can also use the `--live` option to only return Twitch Follows that are currently live or alternatively the `--game` option to only return Twitch Live Streams for a specific Game ID (and optionally in a specific Language by using the `--gameLang` option with an ISO 639-1 two-letter language code).
### Configuration
`cmd/twitch` consumes various environment variables that should be [provided by Alfred](https://www.alfredapp.com/help/workflows/advanced/variables/#environment) when invoking the script in a workflow:
| Environment variable | Description |
| -------------------- | -------------------------------------------------------------- |
| `TWITCH_CLIENT_ID` | A Twitch application client ID. |
| `TWITCH_OAUTH_TOKEN` | A Twitch User access token with the `user:read:follows` scope. |
## BetaSeries
`cmd/betaseries` fetches Shows with Unwatched Episode(s) for a specific [BetaSeries](https://www.betaseries.com) User.
### Usage
`cmd/betaseries` can be executed in a [Run Script Action](https://www.alfredapp.com/help/workflows/actions/run-script/) to return BetaSeries Shows:
```shell
$ betaseries
{
"items": [
{
"title": "Show 1",
"subtitle": "2 episodes remaining (90 total)",
"arg": "123456"
},
{
"title": "Show 2",
"subtitle": "3 episodes remaining (5 total)",
"arg": "456789"
},
…
]
}
```
You can also use the `--watched` option to mark all Aired Unwatched Episodes of a BetaSeries Shows as watched.
### Configuration
`cmd/betaseries` consumes various environment variables that should be [provided by Alfred](https://www.alfredapp.com/help/workflows/advanced/variables/#environment) when invoking the script in a workflow:
| Environment variable | Description |
| ------------------------ | ----------------------------------- |
| `BETASERIES_CLIENT_ID` | A BetaSeries application client ID. |
| `BETASERIES_OAUTH_TOKEN` | A BetaSeries User access token. |
## GitHub
`cmd/github` fetches Repositories and Recent Contributions for a specific [GitHub](https://github.com/) User. Repositories are cached if the `alfred_workflow_cache` environment variable (automatically provided by Alfred) is set.
### Usage
`cmd/github` can be executed in a [Run Script Action](https://www.alfredapp.com/help/workflows/actions/run-script/) to return GitHub Repositories:
```shell
$ github
{
"items": [
{
"title": "user/repo1",
"subtitle": "Last activity 2 hours ago",
"arg": "https://www.github.com/user/repo1"
},
{
"title": "org/repo2",
"subtitle": "Last activity 5 days ago",
"arg": "https://www.github.com/org/repo2"
},
…
]
}
```
You can use the `--clear` option to clear the cached GitHub Repositories.
### Configuration
`cmd/github` consumes an environment variables that should be [provided by Alfred](https://www.alfredapp.com/help/workflows/advanced/variables/#environment) when invoking the script in a workflow:
| Environment variable | Description |
| -------------------- | ------------------------------- |
| `GITHUB_OAUTH_TOKEN` | A GitHub personal access token. |
## Contribute
1. [Fork](https://help.github.com/articles/fork-a-repo) & [clone](https://help.github.com/articles/cloning-a-repository) this repository.
1. Build & run the development version using `go run` for the desired tool.
## License
Licensed under the MIT License, Copyright © HiDeoo.
See [LICENSE](https://github.com/HiDeoo/alfred-workflow-tools/blob/master/LICENSE) for more information.