{"id":13728662,"url":"https://github.com/deepjyoti30/quickwall","last_synced_at":"2025-04-07T18:14:22.419Z","repository":{"id":57459488,"uuid":"201968469","full_name":"deepjyoti30/QuickWall","owner":"deepjyoti30","description":"Set latest wallpapers from Unsplash from the commandline","archived":false,"fork":false,"pushed_at":"2022-02-16T18:09:45.000Z","size":64794,"stargazers_count":191,"open_issues_count":4,"forks_count":8,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-04T21:16:29.455Z","etag":null,"topics":["cli","nitrogen","terminal","unsplash","wallpaper","wallpaper-setter"],"latest_commit_sha":null,"homepage":"https://deepjyoti30.github.io/quickwall","language":"Python","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/deepjyoti30.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":"2019-08-12T16:30:18.000Z","updated_at":"2025-02-17T21:51:25.000Z","dependencies_parsed_at":"2022-09-13T16:01:41.334Z","dependency_job_id":null,"html_url":"https://github.com/deepjyoti30/QuickWall","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepjyoti30%2FQuickWall","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepjyoti30%2FQuickWall/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepjyoti30%2FQuickWall/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepjyoti30%2FQuickWall/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deepjyoti30","download_url":"https://codeload.github.com/deepjyoti30/QuickWall/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247704571,"owners_count":20982298,"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":["cli","nitrogen","terminal","unsplash","wallpaper","wallpaper-setter"],"created_at":"2024-08-03T02:00:47.218Z","updated_at":"2025-04-07T18:14:22.392Z","avatar_url":"https://github.com/deepjyoti30.png","language":"Python","funding_links":[],"categories":["Viewing images"],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eQuickWall\u003c/h1\u003e\n\n\u003cdiv align=\"center\" style=\"padding-top: 2em !important; padding-bottom: 2em; !important\"\u003e\n    \u003cimg src=\".github/qw.gif\" style=\"border-radius: 4px !important;\"\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\u003cbr/\u003e\n\n\u003ca href=\"#how-it-works\"\u003eHow It Works\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;|\u0026nbsp;\u0026nbsp;\u0026nbsp;\u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;|\u0026nbsp;\u0026nbsp;\u0026nbsp;\u003ca href=\"#requirements\"\u003eRequirements\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;|\u0026nbsp;\u0026nbsp;\u0026nbsp;\u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;|\u0026nbsp;\u0026nbsp;\u0026nbsp;\u003ca href=\"#todo\"\u003eTODO\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;|\u0026nbsp;\u0026nbsp;\u0026nbsp;\u003ca href=\"#acknowledgements\"\u003eAcknowledgements\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;\n\u003cbr/\u003e\u003cbr/\u003e\n\n[![forthebadge made-with-python](http://ForTheBadge.com/images/badges/made-with-python.svg)](https://www.python.org/)\u003cbr/\u003e\u003cbr/\u003e\n![Travis (.org)](https://img.shields.io/travis/deepjyoti30/QuickWall?style=for-the-badge) [![License](https://img.shields.io/badge/License-MIT-pink.svg?style=for-the-badge)](LICENSE) ![PyPI](https://img.shields.io/pypi/v/QuickWall?style=for-the-badge) ![PyPI - Downloads](https://img.shields.io/pypi/dm/QuickWall?style=for-the-badge) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-purple.svg?style=for-the-badge)](http://makeapullrequest.com)\n\n\u003c/div\u003e\n\n## How It Works\n\nIt detects your DE or WM, gets wallpapers from **Unsplash** and sets them using either your choice of wallpaper setter or by **nitrogen**. Not enough? It can also change your theme based on the wallpapers that it gets, thanks to [pywal](https://github.com/dylanaraps/pywal).\n\n## Installation\n\n- It is available in Pypi\n\n```sh\npip3 install QuickWall\n```\n\n- Available in AUR [here](https://aur.archlinux.org/packages/quickwall/)\n\n```sh\nyay -S quickwall\n```\n\n\u003e **NOTE**: The directory is changed from `~/.QuickWall` to `~/.cache/QuickWall`. Early users can use `--migrate` option to move their data.\n\n### OR\n\n- Run the following command in the root directory to install QuickWall.\n\n```sh\npython setup.py install\n```\n\n\u003e **NOTE**: If you get **permission denied** error, run the above command with sudo.\n\n## Requirements\n\n1. Python 3.6+\n2. Currently supported wallpaper setters\n\n   - [nitrogen](https://github.com/l3ib/nitrogen)\n   - [feh](https://github.com/derf/feh)\n   - [kde](https://github.com/KDE/plasma-desktop)\n   - [xfce](https://www.xfce.org/)\n   - [gnome/unity](https://www.gnome.org/)\n\n\u003e **NOTE**: These dependencies in linux can be installed in other variants.  \n\u003e For _arch linux_, you can use **pacman** package manager accordingly.\n\n## Usage\n\n```console\nusage: quickwall [-h] [--version] [--clear-cache] [--setter SETTER] [-d] [-t]\n                 [--remove-id ID] [--dir DIR] [--id ID] [--random]\n                 [--search TERM] [--migrate] [--set-lockscreen]\n                 [--level LEVEL] [--list-level]\n\nQuickWall - Quickly set latest wallpapers from Unsplash directly from the\ncommandline.\n\noptions:\n  -h, --help            show this help message and exit\n  --version             show the program version number and exit\n  --clear-cache         Clear the cache from the cache folder\n                        (~/.cache/QuickWall)\n  --setter SETTER       Wallpaper setter to be used. Currently supported ones:\n                        nitrogen, feh, xfce, kde, gnome, unity (default: auto)\n  -d, --disable-blacklist\n                        Disable adding the image to blacklisted ones.\n  -t, --disable-theme   Disable setting a colorscheme extracted from the\n                        wallpaper\n  --remove-id ID        Remove the passed ID from the blacklist.\n  --dir DIR             Directory to download the wallpapers\n  --id ID               Get a photo by its ID.\n  --random              Get random wallpapers.\n  --search TERM         Show wallpapers based on the passed term\n  --migrate             ONLY FOR EARLY USERS. Move the files from ~/.QuickWall\n                        to ~/.cache/QuickWall.\n  --set-lockscreen      Set lockscreen wallpaper (currently for KDE)\n\nLogger:\n  --level LEVEL         The level of the logger that will be used while\n                        verbosing. Use `--list-level` to check available\n                        options.\n  --list-level          List all the available logger levels.\n\n```\n\n## TODO\n\n- Add tests\n- Add support for different wallpaper setters (raise an issue if you want me to support some particular one)\n- Handle errors better\n- ~~Add support for GNOME/Unity~~\n- ~~Add support for XFCE~~\n- ~~Add automatic detection of wallpaper setter depending on the OS. Fallback would be nitrogen.~~\n- ~~Add support to restore wallpapers for KDE.~~\n- ~~Add a logger~~\n- ~~Add support to search~~\n\n## Acknowledgements\n\n- [Unsplash](https://unsplash.com) for their awesome API.\n- [Pavel Borisov](https://github.com/pashazz) for [ksetpaper](https://github.com/pashazz/ksetwallpaper) code.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeepjyoti30%2Fquickwall","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeepjyoti30%2Fquickwall","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeepjyoti30%2Fquickwall/lists"}