github.com/grafana/grafana-kiosk
v1.0.12
#2709 most downloaded on Go modules
grafana/grafana-kiosk
What this package is like to depend on
Last release 3 months ago
01 May 2026
Release timing varies
gaps range from 9 days to 13 months
Nearly every release is documented
notes for 13 of 13 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
29 releases · first in 2019
7 releases in the last 12 months
see the full history below
Release timeline
29 releases · Dec 2019 to May 2026Releases
latest 29-
v1.0.13-0.20260501202955-e428f326a1f501 May 2026 pre-releaseNothing published for this version
-
v1.0.1229 Apr 2026Release notes
Open source →Features
- Add
--incognitoflag to optionally disable Chrome incognito mode (#247) - Add
--hide-logoflag to hide Powered by Grafana logo (#256) - Add
--hide-playlist-navflag to hide playlist navigation controls (#256)
Bug Fixes
- Fix query errors with newer Grafana API (#254) — thanks @llamafilm!
- Fix
hideLogoquery parameter to match Grafana's native format (#262) - Fix Grafana 12+ scenes viewport changes causing kiosk to not autofit panels (#250)
- Fix fullscreen cycle for non-full kiosk modes (
tv,disabled) (#251) - Fix HTTP URLs blocked by Chromium 130+ HTTPS-First Mode (#249)
- Fix CLI flags not overriding config file values when using
-c(#248) - Fix API key host prefix matching to prevent auth header leakage (#244)
CI/CD
- Persist coverage badges, add
actionlint, restrict workflow permissions (#246) - Add coverage badges to README (#245)
Dependencies
- Update Go modules: chromedp/cdproto, magefile/mage, google.golang.org/api, golang.org/x/*, grpc, otel (#243)
- Update
actions/setup-goto v6.4.0 (#236) - Update
google/osv-scanner-actionto v2.3.5 (#235) - Update
softprops/action-gh-releaseto v3 (#259)
Documentation
- Rewrap AGENTS.md in agents-md behavioral template; split project detail into
.agents/topic files (#264)
New Contributors
- @llamafilm made their first contribution in #254
Full Changelog: v1.0.11...v1.0.12
Release notes
Open source →Features
- Add
--incognitoflag to optionally disable Chrome incognito mode (#127) - Add
-hide-logoflag to hide Powered by Grafana logo (#240) - Add
-hide-playlist-navflag to hide playlist navigation controls (#240) - Update
_dash.hideLinks,_dash.hideTimePicker,_dash.hideVariablesquery param values to match Grafana's native format - Add hide flags to startup config summary logging with visual section separators
- Refactor
summary()intologGeneralSettings,logTargetSettings,logGoAuthSettings
Bug Fixes
-
Fix Windows binary missing
.exesuffix in Mage build output -
Fix
hideLogoquery parameter from_dash.hideLogotohideLogoto match Grafana's native format -
Fix Grafana 12+ scenes viewport changes causing kiosk to not autofit panels (#177)
-
Fix
cycleWindowToSizeunconditionally cycling to fullscreen when kiosk mode istvordisabled(#177) -
Fix HTTP URLs blocked by Chromium 130+ HTTPS-First Mode (#155)
-
Fix CLI flags not overriding config file values when using
-c(#210) -
Fix API key host prefix matching to prevent auth header leakage to hosts sharing a prefix with the target
-
Fix broken badge images: push shields.io JSON endpoint to
badgesbranch from CI, use shields.io dynamic badge in README -
Fix query errors with newer Grafana API (#254)
Tests
- Add tests for
IsDataSourceQueryRequestandIsTargetHostRequestin apikey login - Add tests for
sanitizein main and initialize packages - Add tests for
GenerateURLplaylist mode - Add tests for command allowlist in initialize package
- Add tests for
cycleWindowToSize,waitForPageLoad, andwaitForBrowserStartuputilities - Add tests for
loadConfig: malformed YAML, testdata fixtures, env var overrides, all CLI flag overrides (37.5% -> 82.5%) - Add tests for
ProcessArgswith all CLI flags
CI/CD
- Update
actions/upload-artifactfrom v7 to v7.0.1 in CI workflow - Add octocov-action to CI for test coverage reporting on PRs
- Add
pull_requesttrigger to Build CI workflow - Save coverage report as CI artifact
- Disable octocov PR comment, use PR body insertion only
- Add octocov coverage badges to README
- Restrict CI workflow permissions: global
permissions: {}with job-levelcontents: writeandpull-requests: write - Add
actionlintjob to CI for GitHub Actions workflow linting - Fix shellcheck warnings in CI workflow: quote variables, group redirects
- Add
markdownlint.ymlworkflow to lint.mdfiles on push tomainand PRs
Dependencies
- Update Go module dependencies: chromedp/cdproto, magefile/mage v1.17.1, google.golang.org/api v0.275.0, golang.org/x/{crypto,net,sys,text}, google.golang.org/grpc v1.80.0, go.opentelemetry.io/otel v1.43.0, cloud.google.com/go/auth v0.20.0
- Update Docker base images: golang 1.26.2-alpine, dtcooper/raspberrypi-os latest digest
- Update
actions/setup-gofrom v6.3.0 to v6.4.0 in CI workflow (#236) - Update
google/osv-scanner-actionto v2.3.5 in CI workflow (#235) - Update
softprops/action-gh-releaseto v3 in CI workflow (#259)
Documentation
- Expand README window-size/kiosk-mode section with Chrome launch flags, CDP cycling, and Grafana query parameter tables
- Add 10 example YAML config files for dashboard/playlist, fullscreen/tv/windowed, and multi-monitor positioning
- Fix long lines in README.md for MD013 compliance
- Rewrap AGENTS.md around the agents-md behavioral template;
split project-specific detail into topic files under
.agents/(build, code-style, readme-policy, ci, release)
Chores
- Add CLAUDE.md referencing AGENTS.md
- Update AGENTS.md action version table to match current CI pinned versions
- Add MD013 (line length) and MD060 (aligned tables) rules to markdownlint config
- Switch to markdownlint-cli2 with
.markdownlint-cli2.yamlconfig - Add missing technical terms to cspell config
- Replace
CLAUDE.mdinclude stub with symlink toAGENTS.md; addGEMINI.mdsymlink for cross-tool portability - Ignore
CLAUDE.mdandGEMINI.mdsymlinks in markdownlint config to avoid duplicate linting
Release notes
Open source →Features
- Add
--incognitoflag to optionally disable Chrome incognito mode (#127) - Add
-hide-logoflag to hide Powered by Grafana logo (#240) - Add
-hide-playlist-navflag to hide playlist navigation controls (#240) - Update
_dash.hideLinks,_dash.hideTimePicker,_dash.hideVariablesquery param values to match Grafana's native format - Add hide flags to startup config summary logging with visual section separators
- Refactor
summary()intologGeneralSettings,logTargetSettings,logGoAuthSettings
Bug Fixes
- Fix
hideLogoquery parameter from_dash.hideLogotohideLogoto match Grafana's native format - Fix Grafana 12+ scenes viewport changes causing kiosk to not autofit panels (#177)
- Fix
cycleWindowToSizeunconditionally cycling to fullscreen when kiosk mode istvordisabled(#177) - Fix HTTP URLs blocked by Chromium 130+ HTTPS-First Mode (#155)
- Fix CLI flags not overriding config file values when using
-c(#210) - Fix API key host prefix matching to prevent auth header leakage to hosts sharing a prefix with the target
- Fix broken badge images: push shields.io JSON endpoint to
badgesbranch from CI, use shields.io dynamic badge in README - Fix query errors with newer Grafana API (#254)
Tests
- Add tests for
IsDataSourceQueryRequestandIsTargetHostRequestin apikey login - Add tests for
sanitizein main and initialize packages - Add tests for
GenerateURLplaylist mode - Add tests for command allowlist in initialize package
- Add tests for
cycleWindowToSize,waitForPageLoad, andwaitForBrowserStartuputilities - Add tests for
loadConfig: malformed YAML, testdata fixtures, env var overrides, all CLI flag overrides (37.5% -> 82.5%) - Add tests for
ProcessArgswith all CLI flags
CI/CD
- Update
actions/upload-artifactfrom v7 to v7.0.1 in CI workflow - Add octocov-action to CI for test coverage reporting on PRs
- Add
pull_requesttrigger to Build CI workflow - Save coverage report as CI artifact
- Disable octocov PR comment, use PR body insertion only
- Add octocov coverage badges to README
- Restrict CI workflow permissions: global
permissions: {}with job-levelcontents: writeandpull-requests: write - Add
actionlintjob to CI for GitHub Actions workflow linting - Fix shellcheck warnings in CI workflow: quote variables, group redirects
- Add
markdownlint.ymlworkflow to lint.mdfiles on push tomainand PRs
Dependencies
- Update Go module dependencies: chromedp/cdproto, magefile/mage v1.17.1, google.golang.org/api v0.275.0, golang.org/x/{crypto,net,sys,text}, google.golang.org/grpc v1.80.0, go.opentelemetry.io/otel v1.43.0, cloud.google.com/go/auth v0.20.0
- Update Docker base images: golang 1.26.2-alpine, dtcooper/raspberrypi-os latest digest
- Update
actions/setup-gofrom v6.3.0 to v6.4.0 in CI workflow (#236) - Update
google/osv-scanner-actionto v2.3.5 in CI workflow (#235) - Update
softprops/action-gh-releaseto v3 in CI workflow (#259)
Documentation
- Expand README window-size/kiosk-mode section with Chrome launch flags, CDP cycling, and Grafana query parameter tables
- Add 10 example YAML config files for dashboard/playlist, fullscreen/tv/windowed, and multi-monitor positioning
- Fix long lines in README.md for MD013 compliance
- Rewrap AGENTS.md around the agents-md behavioral template;
split project-specific detail into topic files under
.agents/(build, code-style, readme-policy, ci, release)
Chores
- Add CLAUDE.md referencing AGENTS.md
- Update AGENTS.md action version table to match current CI pinned versions
- Add MD013 (line length) and MD060 (aligned tables) rules to markdownlint config
- Switch to markdownlint-cli2 with
.markdownlint-cli2.yamlconfig - Add missing technical terms to cspell config
- Replace
CLAUDE.mdinclude stub with symlink toAGENTS.md; addGEMINI.mdsymlink for cross-tool portability - Ignore
CLAUDE.mdandGEMINI.mdsymlinks in markdownlint config to avoid duplicate linting
- Add
-
v1.0.12-0.20260412053015-a30953e7532812 Apr 2026 pre-releaseNothing published for this version
-
v1.0.1126 Mar 2026Release notes
Open source →What's Changed
- chore(deps): update actions/upload-artifact action to v5 by @renovate-sh-app[bot] in #190
- chore(deps): update actions/stale action to v10 by @renovate-sh-app[bot] in #189
- chore(deps): pin dependencies by @renovate-sh-app[bot] in #191
- chore(deps): update module golang.org/x/crypto to v0.45.0 [security] by @renovate-sh-app[bot] in #200
- Fix temp dir cleanup not running when process receives a signal by @nightio in #212
- chore(deps): update golang docker tag to v1.26 by @renovate-sh-app[bot] in #213
- Add Content-Type header to host requests by @bramalho in #208
- chore(deps): update jwalton/gh-find-current-pr action to v1.3.5 by @renovate-sh-app[bot] in #215
- chore(deps): update google/osv-scanner-action action to v2.3.3 by @renovate-sh-app[bot] in #206
- chore(deps): update securego/gosec action to v2.24.7 by @renovate-sh-app[bot] in #205
- chore(deps): update golangci/golangci-lint-action action to v9 by @renovate-sh-app[bot] in #196
- chore(deps): update actions/upload-artifact action to v7 by @renovate-sh-app[bot] in #218
- chore(deps): update actions/checkout action to v6 by @renovate-sh-app[bot] in #217
- fix(deps): update module github.com/magefile/mage to v1.16.1 by @renovate-sh-app[bot] in #216
- chore(deps): update actions/stale digest to b5d41d4 by @renovate-sh-app[bot] in #204
- Fix Environment Variables Not Working with Command-Line Arguments by @mcder0015 in #199
- Disable kiosk/fullscreen when explicit window size is requested by @nightio in #194
- Fix gosec security violations in lxde.go and main.go by @briangann in #219
- Add AzureAD authentication support by @briangann in #220
- Fix apikey login for Grafana Cloud: remove stale WaitVisible and incorrect Content-Type by @eltondeboer in #222
- chore(deps): update softprops/action-gh-release action to v2.6.0 by @renovate-sh-app[bot] in #221
- chore(deps): update module google.golang.org/grpc to v1.79.3 [security] by @renovate-sh-app[bot] in #223
- chore(deps): update softprops/action-gh-release action to v2.6.1 by @renovate-sh-app[bot] in #224
- fix(deps): update module github.com/chromedp/chromedp to v0.15.0 by @renovate-sh-app[bot] in #230
- chore(deps): update securego/gosec action to v2.25.0 by @renovate-sh-app[bot] in #228
- chore(deps): update magefile/mage-action action to v4 by @renovate-sh-app[bot] in #227
- fix(deps): update github.com/chromedp/cdproto digest to e3e3800 by @renovate-sh-app[bot] in #229
- fix(deps): update module google.golang.org/api to v0.272.0 by @renovate-sh-app[bot] in #225
- docs/fix: add branching policy, fix chromedp build, replace deprecated idtoken API by @briangann in #231
- fix(deps): update mage to v1.17.0 and google.golang.org/api to v0.273.0 by @briangann in #232
- chore(ci): add workflow_dispatch trigger to Build workflow by @briangann in #233
- test: add tests for generateExecutorOptions by @briangann in #234
New Contributors
- @renovate-sh-app[bot] made their first contribution in #190
- @nightio made their first contribution in #212
- @bramalho made their first contribution in #208
- @mcder0015 made their first contribution in #199
- @eltondeboer made their first contribution in #222
Full Changelog: v1.0.10...v1.0.11
Release notes
Open source →- Add AzureAD authentication support for kiosk mode (#211)
- Fix gosec security violations: add command allowlist in LXDE init, sanitize log inputs (#219)
- Update all Go module dependencies to latest versions (#214)
- Disable kiosk/fullscreen when explicit window size is requested (#194)
- Fix environment variables not working with command-line arguments (#199)
- Fix temp dir cleanup not running when process receives a signal (#212)
- Add Content-Type header to host requests (#208)
- Upgrade Go version to 1.26.1
- Add AGENTS.md with build, test, lint, and code style guidelines
- Add branching policy and contribution guidelines to AGENTS.md (#231)
- Update chromedp to v0.15.1 to fix build compatibility (#231)
- Replace deprecated
idtoken.WithCredentialsFilewithoption.WithAuthCredentialsFile(#231) - Update mage to v1.17.0 and google.golang.org/api to v0.273.0 (#232)
- Fix
KIOSK_LOGIN_METHODenv-description to includeaws(#232) - Update README usage documentation (CLI flags and environment
variables) from actual
--helpoutput (#232) - Add README update procedure to AGENTS.md (#232)
- Add changelog policy to AGENTS.md (#232)
- Update
actions/setup-gofrom v6 to v6.3.0 in CI workflow (#232) - Add GitHub Actions update procedure to AGENTS.md (#232)
- Add
workflow_dispatchtrigger to Build CI workflow - Add release process documentation to AGENTS.md
- Add explicit markdownlint requirement for AGENTS.md to formatting guidelines
- Add tests for
generateExecutorOptionsin utils.go (#234) - Add README review policy to AGENTS.md (#234)
- Fix apikey login for Grafana Cloud: remove stale WaitVisible and incorrect Content-Type (#222)
-
v1.0.11-0.20251030234254-de02bc67bfb630 Oct 2025 pre-releaseNothing published for this version
-
v1.0.11-0.20251030152311-c86c51630a5530 Oct 2025 pre-releaseNothing published for this version
-
v1.0.1030 Oct 2025Release notes
Open source →What's Changed
- README: Fix typos in playlist by @unbelauscht in #167
- Accept cookies for AWS grafana automatically by @Lutger in #170
- Feature: implement handling of dash parameters to hide variables, timepicker and links by @pkeuter in #174
- Click "Yes" in "Stay signed in" page when using Microsoft login by @PhilipGeil in #175
- Changed Systemd stage to network-online.target by @aseques in #179
- Fix keyring prompt and update packages by @briangann in #188
New Contributors
- @unbelauscht made their first contribution in #167
- @Lutger made their first contribution in #170
- @pkeuter made their first contribution in #174
- @PhilipGeil made their first contribution in #175
- @aseques made their first contribution in #179
Full Changelog: v1.0.9...v1.0.10
-
v1.0.927 Sep 2024Release notes
Open source →What's Changed
- fix: bypass login for oauth is not reliables by @briangann in #148
- Fix run:local and build:local Mage targets on Linux and Windows by @xnyo in #163
- Fix: Pass Authorization header only to Grafana when using apikey auth by @xnyo in #162
- Ability for 'goauth' to handle the situation if the password field isn't visible on the first screen (or might be visible but breaks the flow) by @nboeckmann in #153
- Add some rough but functional Docker support by @slim-bean in #154
- update packages and bugfixes by @briangann in #164
New Contributors
- @xnyo made their first contribution in #163
- @nboeckmann made their first contribution in #153
- @slim-bean made their first contribution in #154
Full Changelog: v1.0.8...v1.0.9
-
v1.0.9-0.20241002033033-19dc76d94bf702 Oct 2024 pre-releaseNothing published for this version
-
v1.0.9-0.20240927022355-1271471255fd27 Sep 2024 pre-releaseNothing published for this version
-
v1.0.823 Sep 2024Release notes
Open source →What's Changed
- Fix "choose your search engine" pop-up by @LarsStegman in #138
- Fix passing of scale factor by @maximoei in #142
- update modules and workflow by @briangann in #143
New Contributors
- @LarsStegman made their first contribution in #138
- @maximoei made their first contribution in #142
Full Changelog: v1.0.7...v1.0.8
-
v1.0.8-0.20240923022608-3ee7b0d629ec23 Sep 2024 pre-releaseNothing published for this version
-
v1.0.731 May 2024Release notes
Open source →What's Changed
- AzureAD Auto-Login Local Override by @friedpope in #107
- Set flag to disable translator overlay by @ProfKnox in #113
- 20231129 fix build by @briangann in #118
- updating for scaling by @wizardofdevops in #120
- update workflow and go package versions by @briangann in #121
- fix spelling "Launching" by @to-s in #128
- Feature additions by @briangann in #122
- fixes gcom login hang by @briangann in #133
New Contributors
- @friedpope made their first contribution in #107
- @ProfKnox made their first contribution in #113
- @wizardofdevops made their first contribution in #120
- @to-s made their first contribution in #128
Full Changelog: v1.0.6...v1.0.7
-
v1.0.7-0.20240531022912-d1212b89e8af31 May 2024 pre-releaseNothing published for this version
-
v1.0.7-0.20240518015557-3be3d4cfc66f18 May 2024 pre-releaseNothing published for this version
-
v1.0.7-0.20240307040142-33326c959aa107 Mar 2024 pre-releaseNothing published for this version
-
v1.0.7-0.20231129145956-0c0f540a350329 Nov 2023 pre-releaseNothing published for this version
-
v1.0.7-0.20230308053015-821852ebe23508 Mar 2023 pre-releaseNothing published for this version
-
v1.0.608 Mar 2023Release notes
Open source →What's Changed
- markdown lint by @briangann in #18
- Convert to go mod by @briangann in #20
- update docs by @briangann in #21
- new docs for autostarting kiosk as a service/background process by @briangann in #22
- Fix login local by @AlexHeylin in #34
- Add an option to ignore certificate errors by @xanmanning in #26
- update to go 1.14 and modules to prevent crash in v7 by @briangann in #35
- use git lfs by @briangann in #36
- add generic oauth login by @mistadave in #47
- linting fixes, upgrade modules by @briangann in #53
- Updates for v1.0.3 by @briangann in #54
- chore: add codeclimate by @briangann in #56
- fix circle step ordering by @briangann in #58
- add submit button click to gcom login steps by @roketworks in #84
- Update chromedp to v0.8.5 by @siimjuuse in #82
- Validate login method by @siimjuuse in #81
- update packages by @briangann in #85
- Idtoken Service Account auth by @marcusramberg in #75
- 20221012 fix login method check by @briangann in #86
- fix duplicate yaml config key by @briangann in #87
- fix paths for release and excludes by @briangann in #89
- Add an example on how to disable screensaver and monitor standby in the systemd service description. by @penguineer in #91
- switch to mage and git workflows by @briangann in #100
- Adds support for Grafana API key Auth by @ronansalmon in #93
- Update README.md - example config by @0xUnicorn in #95
- feat: add the ability to set window-size by @gaetanars in #101
- add
autoplay-policyoption to chromedp flags by @legnoh in #99 - feat: add support for aws managed grafana by @pkarakal in #96
- Adds UserAgent and CPU Usage optimization by @briangann in #102
- fix autofit logic by @briangann in #103
- Switch to deep checkout needed for release action by @penguineer in #104
- fix client version by @briangann in #105
New Contributors
- @AlexHeylin made their first contribution in #34
- @xanmanning made their first contribution in #26
- @mistadave made their first contribution in #47
- @roketworks made their first contribution in #84
- @siimjuuse made their first contribution in #82
- @marcusramberg made their first contribution in #75
- @penguineer made their first contribution in #91
- @ronansalmon made their first contribution in #93
- @0xUnicorn made their first contribution in #95
- @gaetanars made their first contribution in #101
- @legnoh made their first contribution in #99
- @pkarakal made their first contribution in #96
Full Changelog: v1.0.0...v1.0.6
Release notes
Open source →- Includes PR#93 - adds authentication with API Key!
- Reduces app CPU utilization to near zero while running
- Adds version to build based on git tag
- Adds user agent with kiosk version
- Switch to git workflow for builds
- Switch to Mage for building instead of make
- Update go modules
-
v1.0.512 Oct 2022Release notes
Open source →- Update go modules to fix continuous error messages
- Updated linters and circleci config for go 1.19
- Adds support for Google IAP Auth (idtoken)
- Fixes GCOM auth login hanging
Release notes
Open source →- Update go modules to fix continuous error messages
- Updated linters and circleci config for go 1.19
- Adds support for Google IAP Auth (idtoken)
- Fixes GCOM auth login hanging
-
v1.0.429 Jun 2021 -
v1.0.329 Jun 2021Release notes
Open source →- OAuth merged
- Fix Grafana Cloud login
- Updated modules
- Added "window-position" option, allows running kiosk on different displays
- Added
--check-for-update-interval=31536000to default flags sent to chromium to workaround update popup
Release notes
Open source →- OAuth merged
- Fix Grafana Cloud login
- Updated modules
- Added "window-position" option, allows running kiosk on different displays
- Added
--check-for-update-interval=31536000to default flags sent to chromium to workaround update popup
-
v1.0.217 May 2020Release notes
Open source →- Also compatible with Grafana v7
- New flag to ignore SSL certificates for local login
- Updated chromedp and build with go 1.14.2
- New configuration file based startup
-
v1.0.120 Dec 2019 -
v1.0.1-0.20221012205734-4257cb9ed74b12 Oct 2022 pre-releaseNothing published for this version
-
v1.0.1-0.20210629192826-211e5bd5cb5429 Jun 2021 pre-releaseNothing published for this version
-
v1.0.1-0.20200517055103-bdd9d7b54ff117 May 2020 pre-releaseNothing published for this version
-
v1.0.020 Dec 2019 -
v0.0.0-20230308053015-821852ebe23508 Mar 2023 pre-releaseNothing published for this version