{"id":13610268,"url":"https://github.com/AlfredoSequeida/venus","last_synced_at":"2025-04-12T22:33:14.920Z","repository":{"id":34978208,"uuid":"153707809","full_name":"AlfredoSequeida/venus","owner":"AlfredoSequeida","description":"Venus aims to be a cross-platform tool to automatically change your desktop wallpaper to something random using images from Unsplash.","archived":false,"fork":false,"pushed_at":"2023-01-29T03:05:17.000Z","size":63958,"stargazers_count":27,"open_issues_count":12,"forks_count":6,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-06T21:37:20.037Z","etag":null,"topics":["cross-platform","desktop-wallpaper","hacktoberfest","linux","macos","osx","pywal","resolution","unsplash","wallpaper","windows"],"latest_commit_sha":null,"homepage":"","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/AlfredoSequeida.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":"2018-10-19T01:12:12.000Z","updated_at":"2025-03-23T14:01:43.000Z","dependencies_parsed_at":"2023-02-15T20:31:12.842Z","dependency_job_id":null,"html_url":"https://github.com/AlfredoSequeida/venus","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlfredoSequeida%2Fvenus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlfredoSequeida%2Fvenus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlfredoSequeida%2Fvenus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlfredoSequeida%2Fvenus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AlfredoSequeida","download_url":"https://codeload.github.com/AlfredoSequeida/venus/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248641708,"owners_count":21138253,"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":["cross-platform","desktop-wallpaper","hacktoberfest","linux","macos","osx","pywal","resolution","unsplash","wallpaper","windows"],"created_at":"2024-08-01T19:01:43.087Z","updated_at":"2025-04-12T22:33:14.579Z","avatar_url":"https://github.com/AlfredoSequeida.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"Venus: For those that get bored of looking at their wallpaper \n===============================================================\n\n[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://GitHub.com/Naereen/StrapDown.js/graphs/commit-activity)\n[![PyPI license](https://img.shields.io/pypi/l/ansicolortags.svg)](https://pypi.python.org/pypi/ansicolortags/)\n[![Downloads](https://pepy.tech/badge/venuspy)](https://pepy.tech/project/venuspy)\n\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://imgur.com/W1E85ZK.png\" alt=\"venus\"\u003e\n    \u003c/br\u003e\n    \u003c/br\u003e\n    \u003cimg src=\"https://imgur.com/ZdNOhIo.gif\" alt=\"\"\u003e\n\u003c/p\u003e\n\nVenus aims to be a cross-platform tool to automatically change your desktop wallpaper using images from [Unsplash](https://unsplash.com/). By default, all images are stored in the system's temporary directory, this way their disposal is handled by the operating system. \n\n\nVenus also handles using images that work with your resolution.\n\n---\n\nNote for the adventurous -\u003e set venus as a startup program. This way you can see what awaits you with each reboot :)\n\n# Installation\n1) Install using pip3 \n\nLinux/OSX\n\n```\npip3 install venuspy \n```\n\nWindows \n\n```\npy -m pip install venuspy \n```\n\n\n# Usage\n1) Just type venus!\n \nLinux/OSX\n\n```\nvenus \n```\n\nWindows \n\n```\npy -m venus \n```\n\nYou can also supply search terms to the command:\n\n```\nvenus landscape nature car\n```\n\n# Config\nVenus can be configured for specific search terms to get a category of images.\n\nEdit the config file located in:\n\n```\n~/.config/venus/config\n```\n\nBy default, the search terms are empty, which means the image selection will be random. To choose what kind of images you want, enter search terms separated by commas.\n\nHere is an example:\n\n```\nSEARCH_TERMS = landscape,nature,car\n```\n\n\u003e Search terms in the command will overwrite those from the config.\n\nTo get images of a specific Unsplash [collection](https://unsplash.com/collections), use its id:\n\n```\nCOLLECTION_ID = 1053828\n```\n\u003e Note: If `COLLECTION_ID` is set, the `SEARCH_TERMS` is ignored.\n\nBy default all images are stored as temporary files in the temp directory of the operating system. To change the location where the images are stored, edit the OUTPUT_PATH option.\n\n\nHere is an example:\n\n```\nOUTPUT_PATH = /home/user/Pictures\n```\n\nVenus has the option of using a timer to change your wallpaper given an interval in seconds.\n\nHere is an example that changes the wallpaper every 60 seconds (1 minute):\n\n```\nWAIT_TIME = 60\n```\n\nBy default a image is requested with the resoluton of your screen. If you need to change that for any reason (if your screen resolution is not available by Unsplash and you are getting a 404 image as your wallpaper), edit the SCREEN_RESOLUTION option. Here is an example:\n\n```\nSCREEN_RESOLUTION = 1920x1080\n```\n\nVenus supports using [pywal](https://github.com/dylanaraps/pywal) as an addon.\nTo use pywal first [install it](https://github.com/dylanaraps/pywal/wiki/Installation), \nthen enable it in the config file:\n\n```\nUSE_PYWAL = True \n```\n\nTo limit the number of files stored locally and prevent filling your disk, set the `CACHE_ITEMS` option (`0` is infinite)\n\n```\nCACHE_ITEMS = 10\n```\n\nCurrent Version 1.0.3 - verified working on\n -----------------\n - [x] Feh 3.5\n - [x] Gnome 3.28\n - [x] KDE Plasma 5.15.4\n - [x] Sway 1.2\n - [x] macOS High Sierra\n - [x] macOS Mojave\n - [x] Windows 10\n\n \n \n How to Contribute\n-----------------\n\n1.  Check for open issues or open a fresh issue to start a discussion\n    around a feature idea or a bug [here](https://github.com/AlfredoSequeida/venus/issues)\n    tag for issues that should be ideal for people who are not very familiar with the codebase yet.\n2.  Fork [the repository](https://github.com/alfredosequeida/venus) on\n    GitHub to start making your changes to the **master** branch (or branch off of it).\n3.  Write a test which shows that the bug was fixed or that the feature\n    works as expected.\n4.  Send a pull request and bug the maintainer until it gets merged and\n    published. :) Make sure to add yourself to\n    [AUTHORS](https://github.com/AlfredoSequeida/venus/blob/master/AUTHORS).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAlfredoSequeida%2Fvenus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAlfredoSequeida%2Fvenus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAlfredoSequeida%2Fvenus/lists"}