{"id":20260914,"url":"https://github.com/CreativeCodeCat/multimonitorlock","last_synced_at":"2025-05-07T14:30:30.588Z","repository":{"id":52673523,"uuid":"268122890","full_name":"CreativeCodeCat/multimonitorlock","owner":"CreativeCodeCat","description":":lock: i3lock wrapper with multi-monitor support","archived":false,"fork":false,"pushed_at":"2021-08-20T14:29:28.000Z","size":88,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-03T22:57:16.825Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CreativeCodeCat.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}},"created_at":"2020-05-30T16:58:08.000Z","updated_at":"2025-04-29T03:48:59.000Z","dependencies_parsed_at":"2022-08-22T03:40:59.295Z","dependency_job_id":null,"html_url":"https://github.com/CreativeCodeCat/multimonitorlock","commit_stats":null,"previous_names":["hecodes2much/multimonitorlock","creativecodecat/multimonitorlock"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CreativeCodeCat%2Fmultimonitorlock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CreativeCodeCat%2Fmultimonitorlock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CreativeCodeCat%2Fmultimonitorlock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CreativeCodeCat%2Fmultimonitorlock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CreativeCodeCat","download_url":"https://codeload.github.com/CreativeCodeCat/multimonitorlock/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252895467,"owners_count":21821165,"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":[],"created_at":"2024-11-14T11:22:59.459Z","updated_at":"2025-05-07T14:30:30.292Z","avatar_url":"https://github.com/CreativeCodeCat.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# multimonitorlock\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Maintained%3F-Yes-green?style=for-the-badge\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/license/The-Repo-Club/multimonitorlock?style=for-the-badge\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/issues/The-Repo-Club/multimonitorlock?color=violet\u0026style=for-the-badge\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/stars/The-Repo-Club/multimonitorlock?style=for-the-badge\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/forks/The-Repo-Club/multimonitorlock?color=teal\u0026style=for-the-badge\"\u003e\n\u003c/p\u003e\n\n[About](#about) [Features](#features) [Requirements](#requirements) [Install](#install) [Usage](#usage) [Examples](#examples) [Configuration](#configuration) [Issues](#issues) [Contributing](#contributing) [Tips](#tips) [License](#license)\n\n![multimonitorlock](https://camo.githubusercontent.com/bd90f582f8fea8467dc59b8b9c5f154aa1dff00f/68747470733a2f2f692e696d6775722e636f6d2f4a5a6139644c432e706e67)\n\n### About\n`multimonitorlock` is a wrapper script for `i3lock-color`. It allows you to cache background images for `i3lock-color` with a variety of different effects and adds a stylish indicator.\n\nOriginally a fork of [betterlockscreen](https://github.com/pavanjadhaw/betterlockscreen) with support for multiple monitors, `multimonitorlock` has grown considerably. There are a tons of new and useful features.\n\n### Features\n- Support for multiple monitors with almost any layout\n- Support for HiDPI monitors\n- A bunch of cool image effects\n- Apply one effect, all effects, or anything in between\n- A stylish, themeable indicator\n- Set desktop wallpaper to match\n\n### Requirements\n- [i3lock-color](https://github.com/PandorasFox/i3lock-color) - i3lock fork with additional features  \n- [imagemagick](https://www.imagemagick.org/) - Image effects  \n- [xrandr](https://www.x.org/) - Display info  \n- [xdpyinfo](https://www.x.org/) - Display info \u0026 HiDPI support\n- [multimonitorlock-gui](https://github.com/The-Repo-Club/multimonitorlock-gui) - Set background  \n\n### Install\n##### Manual Installation\n```bash\ngit clone https://github.com/The-Repo-Club/multimonitorlock\ncd multimonitorlock\nsudo install -Dm 755 multimonitorlock /usr/local/bin/multimonitorlock\n```\n##### Arch Linux (AUR)\n```bash\ngit clone https://aur.archlinux.org/multimonitorlock.git\ncd multimonitorlock-git\nless PKGBUILD\nmakepkg -si\n```\n\n### Usage\n```bash\nUsage: multimonitorlock [-u \u003cPATH\u003e] [-l \u003cEFFECT\u003e] [-w \u003cEFFECT\u003e]\n\n  -u --update \u003cPATH\u003e\n      Update lock screen image\n\n  -l --lock \u003cEFFECT\u003e\n      Lock screen with cached image\n      (Could be use alongside --suspend to show lock screen after waking up from suspend)\n\n  -s --suspend\n      Suspend the system\n      (Could be use alongside --lock to show lock screen after waking up from suspend)     \n\n  -w --wall \u003cEFFECT\u003e\n      Set wallpaper with cached image\n\nAdditional arguments:\n\n  --display \u003cN\u003e\n      Set display to draw loginbox\n\n  --span\n      Scale image to span multiple displays\n\n  --off \u003cN\u003e\n      Turn display off after N minutes\n\n  --fx \u003cEFFECT,EFFECT,EFFECT\u003e\n      List of effects to apply\n\n  -- \u003cARGS\u003e\n      Pass following arguments to i3lock\n\nEffects arguments:\n\n  --dim \u003cN\u003e\n      Dim image N percent (0-100)\n\n  --blur \u003cN\u003e\n      Blur image N amount (0.0-1.0)\n\n  --pixel \u003cN,N\u003e\n      Pixelate image with N shrink and N grow (unsupported)\n\n  --color \u003cHEX\u003e\n      Solid color background with HEX\n```\n\n### Examples\nUpdate image cache with random image  \n`multimonitorlock --update ~/Wallpapers`  \n\nUpdate image cache with only dim and pixel effects  \n`multimonitorlock -u ~/Wallpapers/image.png --fx dim,pixel`  \n\nUpdate image cache with multiple monitors, spanning  \n`multimonitorlock -u ~/Wallpapers/Dual/ --fx dimblur,color --display 1 --span`  \n\nUpdate image cache with solid background only (ignore errors)  \n`multimonitorlock -u . --fx color --color 5833ff`  \n\nUpdate image cache with different background images  \n`multimonitorlock -u ~/Wallpapers/image1.png -u ~/Wallpapers/image2.png --fx dimpixel --display 1`  \n\nLock screen with blur effect  \n`multimonitorlock --lock blur`  \n\nLock screen with multiple monitors, spanning  \n`multimonitorlock -l dimblur --display 1 --span`  \n\n### Configuration\nCopy the example config to `~/.config/multilock/config`  \n```ini\n# default options\ndisplay_on=0\nspan_image=false\nlock_timeout=300\nfx_list=(dim blur dimblur pixel dimpixel color)\ndim_level=40\nblur_level=1\npixel_scale=10,1000\nsolid_color=333333\n\n# theme options\nloginbox=00000066\nloginshadow=00000000\nlocktext=\"Type password to unlock...\"\nfont=\"sans-serif\"\nringcolor=ffffffff\ninsidecolor=00000000\nseparatorcolor=00000000\nringvercolor=ffffffff\ninsidevercolor=00000000\nringwrongcolor=ffffffff\ninsidewrongcolor=d23c3dff\nkeyhlcolor=d23c3dff\nbshlcolor=d23c3dff\nverifcolor=ffffffff\ntimecolor=ffffffff\ndatecolor=ffffffff\n```\n\n### Issues\nFeel free to open an Issue if you need help or have any question.\n\nBefore doing so, please look at both open and closed Issues to see if the issue has already been reported or solved.\n\nProvide details. When submitting an issue, please give the exact command you trying to run. If you are using the config file, post that as well. Problems with `--update`, provide `convert --version` output. Problems with `--lock`, provide `i3lock --version` output.\n\n### Contributing\nPull Requests are weclome! Please try to keep PRs as simple as possible. Add one feature, fix one issue, etc. The easier they are to review, the faster they get merged.\n\nPlease try stick with the format of the files (tabs, spacing, etc.). Don't make any \"while I'm here\" edits. And please document where appropriate.\n\nNew to Pull Requests? I suggest this [Pull Request Etiquette](https://gist.github.com/mikepea/863f63d6e37281e329f8) gist.\n\n### Tips\nDo not use systemd service. `xautolock` is recommended instead  \n```bash\n# .xinitrc\nxautolock -time 10 -locker 'multimonitorlock -l -- --timestr=\"%H:%M\"' \u0026\n```\n\n### License\nmultimonitorlock is under [GPL](https://github.com/The-Repo-Club/multimonitorlock/blob/multi-monitor/LICENSE) license\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCreativeCodeCat%2Fmultimonitorlock","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FCreativeCodeCat%2Fmultimonitorlock","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCreativeCodeCat%2Fmultimonitorlock/lists"}