{"id":21690518,"url":"https://github.com/aesophor/displayctl","last_synced_at":"2026-03-09T19:34:31.310Z","repository":{"id":158156057,"uuid":"114887514","full_name":"aesophor/displayctl","owner":"aesophor","description":"💡 Resolution, brightness, wallpaper, lockscreen manager","archived":false,"fork":false,"pushed_at":"2020-03-08T02:02:19.000Z","size":10197,"stargazers_count":61,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-06T16:50:38.074Z","etag":null,"topics":["brightness","display-resolution","i3lock","lockscreen","resolution","wallpaper","xrandr"],"latest_commit_sha":null,"homepage":"https://www.reddit.com/r/unixporn/comments/7l6o3a/i3lock_displayctl_a_utility_to_handle_various/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aesophor.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-12-20T12:56:28.000Z","updated_at":"2024-07-11T15:10:02.000Z","dependencies_parsed_at":"2023-07-12T20:30:27.023Z","dependency_job_id":null,"html_url":"https://github.com/aesophor/displayctl","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aesophor%2Fdisplayctl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aesophor%2Fdisplayctl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aesophor%2Fdisplayctl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aesophor%2Fdisplayctl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aesophor","download_url":"https://codeload.github.com/aesophor/displayctl/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248548990,"owners_count":21122808,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["brightness","display-resolution","i3lock","lockscreen","resolution","wallpaper","xrandr"],"created_at":"2024-11-25T17:31:35.380Z","updated_at":"2026-03-09T19:34:31.270Z","avatar_url":"https://github.com/aesophor.png","language":"Shell","readme":"\u003cdiv align=\"center\"\u003e\n\u003ch3\u003eDISPLAYCTL\u003c/h3\u003e\n\u003cimg src=\"https://github.com/aesophor/displayctl/raw/master/assets/main.png\"\u003e\n\n`Wallpapers (Desktop/Lockscreen) with Effects (Normal/Dim/Blur)`\n`Resolution` `Brightness` `Lockscreen` \n\u003c/div\u003e\n\n## Why Do I Need This?\nAre you running a Window Manager without a DE? Ever experienced the inconvenience of running `xrandr` to set resolution, `feh` for wallpaper, `light` for brightness, and `i3lock` for lockscreen? (I use these tools, in my case)\n\nI wrote displayctl to eradicate these problems. Now you can handle these tasks with a single script!\n\n## Dependencies\n* imagemagick\n* ffmpeg\n* xrandr\n* [light](https://github.com/haikarainen/light)\n* [i3lock-color](https://github.com/PandorasFox/i3lock-color)\n\n## Installation\nCurrently it only supports manual installation, sorry! Supports for several common distributions will be added later!\n* Manual Installation\n```\n$ git clone https://github.com/aesophor/displayctl.git\n$ cd displayctl \u0026\u0026 cp displayctl ~/.local/bin/displayctl\n```\n\n## Configuration\nAdd this line to your `~/.Xresources`\n```\n! displayctl\n#include \"/home/aesophor/.x/displayctlrc\"\n```\n\nThen create the configuration file in `~/.x/displayctlrc` \n```\n! displayctlrc\n! ===================================================================================\nDisplay.monitor:         eDP1\nDisplay.dpi:             112\nDisplay.resolution:      1680x1050\nDisplay.brightness:      30\nDisplay.wallpaper:       /home/aesophor/Pictures/Wallpapers/Nature/Rainy.jpeg\nDisplay.lockscreen:      /home/aesophor/Pictures/Wallpapers/Landscape/Pebble.jpeg\n```\n\nEach time after modifying displayctlrc, run\n```\nxrdb -merge ~/.Xresources\n```\n\n## Usage\nLockscreen cache can be located at `/tmp/lock_cache.png`. It will be stored there for faster lockscreen invocation. \n\nTo use the lockscreen with another effect, run `displayctl -c` to clear the cache first.\n```\n$ displayctl                  # Restore resolution, brightness, and wallpaper to last session \n$ displayctl -d               # Restore resolution and brightness to last session\n$ displayctl -l               # Invoke lockscreen (i3lock-color required)\n$ displayctl -l -d -b         # Invoke lockscreen with dim + blur effect\n$ displayctl -w -d -b         # Set wallpaper with dim + blur effect\n$ displayctl -e 1280x800      # Mirrors display to an external monitor\n$ displayctl -c               # Clears lockscreen cache\n```\n\n## Gallery\nThe effects demonstrated below can be applied to Desktop Wallpapers as well.\n\n* Lockscreen (Normal)\n![None](https://github.com/aesophor/displayctl/raw/master/assets/main.png)\n\n* Lockscreen (Dim)\n![None](https://github.com/aesophor/displayctl/raw/master/assets/dim.png)\n\n* Lockscreen (Blur)\n![None](https://github.com/aesophor/displayctl/raw/master/assets/blur.png)\n\n* Lockscreen (Dim + Blur)\n![None](https://github.com/aesophor/displayctl/raw/master/assets/dimblur.png)\n## License\nAvailable under the [MIT License](https://github.com/aesophor/dotfiles/blob/master/LICENSE).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faesophor%2Fdisplayctl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faesophor%2Fdisplayctl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faesophor%2Fdisplayctl/lists"}