{"id":13617845,"url":"https://github.com/genzj/pybingwallpaper","last_synced_at":"2025-04-14T06:35:57.306Z","repository":{"id":10675767,"uuid":"12912685","full_name":"genzj/pybingwallpaper","owner":"genzj","description":"Download wallpaper from bing.com","archived":false,"fork":false,"pushed_at":"2021-11-20T18:29:43.000Z","size":765,"stargazers_count":549,"open_issues_count":11,"forks_count":104,"subscribers_count":39,"default_branch":"master","last_synced_at":"2025-04-12T21:48:02.449Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/genzj.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-zhcn.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-09-18T02:57:04.000Z","updated_at":"2025-04-03T08:20:08.000Z","dependencies_parsed_at":"2022-07-14T01:40:30.729Z","dependency_job_id":null,"html_url":"https://github.com/genzj/pybingwallpaper","commit_stats":null,"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/genzj%2Fpybingwallpaper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/genzj%2Fpybingwallpaper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/genzj%2Fpybingwallpaper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/genzj%2Fpybingwallpaper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/genzj","download_url":"https://codeload.github.com/genzj/pybingwallpaper/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248836235,"owners_count":21169367,"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-08-01T20:01:49.168Z","updated_at":"2025-04-14T06:35:56.975Z","avatar_url":"https://github.com/genzj.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# PyBingWallpaper\n\n## What pybingwallpaper does\n\nDownload the wallpaper offered by [*Bing.com*](https://www.bing.com) and set it \ncurrent wallpaper background.\n\nAnother project for the same purpose but download from National Geographic can \nbe found [here](https://github.com/genzj/pyngwallpaper)\n\n----------\n\n## Auto startup\n\n### Windows\n\nDownload installer from [releases page](https://github.com/genzj/pybingwallpaper/releases) and install it.\n\n\u003cp\u003e**Note: Please backup the `settings.conf` under the installation path before upgrading!**\u003c/p\u003e\n\u003cp\u003e**注意：建议升级前备份安装目录下的`settings.conf`文件！**\u003c/p\u003e\n\nA shortcut will be created in your startup folder. You can edit the configuration to adjust features.\n\n### Linux with Gnome\n\nYou just need to add a startup application:\n\n    gnome-session-properties\n\nthen *add* a startup program with:\n\n    Name: pybingwallpaper\n    Command: python3 /path/to/pybingwallpaper/src/main.py -b\n    Comment: download and update wallpaper!\n\nYou can also append arguments in *Command* box.\n\n----------\n\n## Usage\n\n    usage: pybingwallpaper [-h] [-v] [--config-file CONFIG_FILE]\n                           [--generate-config] [-b] [--foreground]\n                           [-c {au,br,ca,cn,de,fr,jp,nz,us,uk,auto}]\n                           [--market MARKET] [-d] [-i INTERVAL] [-k]\n                           [-m {prefer,collect,highest,insist,manual,never}]\n                           [--collect COLLECT] [--image-size IMAGE_SIZE]\n                           [-o OFFSET] [--proxy-server PROXY_SERVER]\n                           [--proxy-port PROXY_PORT]\n                           [--proxy-username PROXY_USERNAME]\n                           [--proxy-password PROXY_PASSWORD] [--redownload]\n                           [-s {no,win,gnome2,gnome3}] [--setter-args SETTER_ARGS]\n                           [-t OUTPUT_FOLDER] [--database-file DATABASE_FILE]\n                           [--database-no-image] [--server {global,china,custom}]\n                           [--custom-server CUSTOMSERVER]\n\n    Download the wallpaper offered by Bing.com and set it current wallpaper\n    background.\n\n    optional arguments:\n      -h, --help            show this help message and exit\n      -v, --version         show version information\n      --config-file CONFIG_FILE\n                            'specify configuration file, use `settings.conf` in\n                            installation directory by default.\n      --generate-config     generate a configuration file containing arguments\n                            specified in command line and exit. to generate\n                            default config file, issue without other command\n                            arguments. path and name of configuration file can be\n                            specified with --config-file\n      -b, --background      work in background (daemon mode) and check wallpaper\n                            periodically (interval can be set by --interval).\n      --foreground          force working in foreground mode to cancel the effect\n                            of `background` in config file.\n      -c {au,br,ca,cn,de,fr,jp,nz,us,uk,auto}, --country {au,br,ca,cn,de,fr,jp,nz,us\n    ,uk,auto}\n                            select country code sent to bing.com. bing.com in\n                            different countries may show different backgrounds.\n                            au: Australia br: Brazil ca: Canada cn: China\n                            de:Germany fr: France jp: Japan nz: New Zealand us:\n                            USA uk: United Kingdom auto: select country according\n                            to your IP address (by Bing.com) Note: only China(cn),\n                            New Zealand(nz) and USA(us) have high resolution\n                            (1920x1200) wallpapers; the rest offer 1366x768 only.\n      --market MARKET       specify market from which the wallpaper should be\n                            downloaded. Market is a more generic way to specify\n                            language-country of bing.com. The list of markets may\n                            grow sometimes, and different language of the same\n                            country may have different image, so consider using it\n                            instead of country. Market code should be specified in\n                            format 'xy-ab' such as en-us. Note: specify this\n                            parameter will override any settings to --country.\n      -d, --debug           enable debug outputs. The more --debug the more\n                            detailed the log will be\n      -i INTERVAL, --interval INTERVAL\n                            interval between each two wallpaper checkings in unit\n                            of hours. applicable only in `background` mode. at\n                            lease 1 hour; 2 hours by default.\n      -k, --keep-file-name  keep the original filename. By default downloaded file\n                            will be renamed as 'wallpaper.jpg'. Keep file name\n                            will retain all downloaded photos\n      -m {prefer,collect,highest,insist,manual,never,uhd}, --size-mode {prefer,collect,highest,insist,manual,never,uhd}\n                            set selecting strategy when wallpapers in different\n                            size are available (4K, 1920x1200, 1920x1080 and\n                            1366x768). `prefer` (default) detect and download the\n                            highest available resolution; `insist` always use\n                            1920x1200 resolution and ignore other pictures (Note:\n                            some countries have only normal size wallpapers, if\n                            `insist` is adopted with those sites, no wallpaper can\n                            be downloaded, see `--country` for more); `highest` is\n                            an alias of `prefer` `never` always use normal\n                            resolution (1366x768); `manual` use resolution\n                            specified in `--image-size` `collect` is obsolete and\n                            only kept for backward compatibility, equals `prefer`\n                            mode together with --collect=accompany option. `uhd`\n                            insists using 4K resolution, or abort wallpaper\n                            downloading if it's not available.\n      --collect COLLECT     items to be collected besides main wallpaper, can be\n                            assigned more than once in CLI or as comma separated\n                            list from config file. currently `accompany`, `video`\n                            and `hdvideo` are supported. `accompany` - some\n                            markets (i.e. en-ww) offers two wallpapers every day\n                            with same image but different Bing logo (English and\n                            Chinese respectively). enables this will download both\n                            original wallpaper and its accompanyings. `video` -\n                            bing sometimes (not everyday) release interesting\n                            animated mp4 background, use this to collect them.\n                            `hdvideo` - HD version of video.\n      --image-size IMAGE_SIZE\n                            specify resolution of image to download. check\n                            `--size-mode` for more\n      -o OFFSET, --offset OFFSET\n                            start downloading from the photo of 'N' days ago.\n                            specify 0 to download photo of today.\n      --proxy-server PROXY_SERVER\n                            proxy server url, ex: http://10.1.1.1\n      --proxy-port PROXY_PORT\n                            port of proxy server, default: 80\n      --proxy-username PROXY_USERNAME\n                            optional username for proxy server authentication\n      --proxy-password PROXY_PASSWORD\n                            optional password for proxy server authentication\n      --redownload          do not check history records. Download must be done.\n                            downloaded picture will still be recorded in history\n                            file.\n      -s {no,win,gnome2,gnome3}, --setter {no,win,gnome2,gnome3}\n                            specify interface to be called for setting wallpaper.\n                            'no' indicates downloading-only; 'gnome2/3' are only\n                            for Linux with gnome; 'win' is for Windows only.\n                            Customized setter can be added as dev doc described.\n                            Default: win for win32, gnome3 for Linux\n      --setter-args SETTER_ARGS\n                            arguments for external setters\n      -t OUTPUT_FOLDER, --output-folder OUTPUT_FOLDER\n                            specify the folder to store photos. Use\n                            '~/MyBingWallpapers' folder in Linux, 'C:/Documents\n                            and Settings/\u003cyour-username\u003e/MyBingWallpapers in\n                            Windows XP or 'C:/Users/\u003cyour-\n                            username\u003e/MyBingWallpapers' in Windows 7 by default\n      --database-file DATABASE_FILE\n                            specify the sqlite3 database used to store meta info\n                            of photos. leave it blank to disable database storage.\n      --database-no-image   images will be embedded into database by default.\n                            Exclude images from database can reduce the size of\n                            database file.\n      --server {global,china,custom}\n                            select bing server used for meta data and wallpaper\n                            pictures. it seems bing.com uses different servers and\n                            domain names in china. global: use bing.com of course.\n                            china: use s.cn.bing.net. (note: use this may freeze\n                            market or country to China zh-CN) custom: use the\n                            server specified in option \"customserver\"\n      --custom-server CUSTOMSERVER\n                            specify server used for meta data and wallpaper photo.\n                            you need to set --server to 'custom' to enable the\n                            custom server address.\n----------\n\n## Release Note\n\n* **2021-03-19 1.6.0**\n  * Support UHD resolution (#63)\n  * `highest` mode is an alias of `prefer` now.\n\n* **2019-04-30 1.5.5**\n  * Compatible with Bing's new URL format (accompany pictures this time, #55 #56)\n\n* **2019-03-15 1.5.4**\n  * Compatible with Bing's new URL format\n\n* **2016-04-06 1.5.1**\n  * Minor bug fix for Python 3.5 (#43)\n  * Obsolete 1.5.0 due to MS Windows Defender raise (false) alarm on the\n    installer (#44)\n\n* **2015-12-08 1.5.0**\n  * Can collect video now! (#34)\n  * Decouple collect mode from market setting (#35)\n  * Better compatibility with win 8 and higher (#31 and #40)\n  * Avoid deleting collected wallpaper at uninstallation (#33)\n\n* **2014-09-08 1.4.4**\n  * Support configurable bing server address (#27)\n\n* **2014-04-18 1.4.4b01**\n  * Support download records database (#18), you can build you own bing album now. \n\n* **2013-12-24 1.4.3**\n  * Fix #13 enhance robustness of network connection status: retry in\n    60 seconds after network failure \n  * Fix #14 download image with Chinese logo whenever a 1920x1200 picture is\n    downloaded: add a collect mode, read \n    [use collect mode](https://github.com/genzj/pybingwallpaper/wiki/Use-collect-mode) \n    [使用收集模式](https://github.com/genzj/pybingwallpaper/wiki/%E4%BD%BF%E7%94%A8%E6%94%B6%E9%9B%86%E6%A8%A1%E5%BC%8F)\n    for more\n  * Fix #15 use n=1 instead of n=10 for more backtracking room: change\n    default n to 1\n  * Fix #16 can't read settings.conf when run out of installation dir: read\n    settings.conf from the same path of main.py by default\n\n* **2013-12-24 1.4.2**\n  * Support http/https proxy.\n    Read\n    [配置指南](https://github.com/genzj/pybingwallpaper/wiki/%E5%A6%82%E4%BD%95%E9%85%8D%E7%BD%AE%E4%BB%A3%E7%90%86%E6%A8%A1%E5%BC%8F) \n    [Proxy guidance](https://github.com/genzj/pybingwallpaper/wiki/How-to-use-pybingwallpaper-with-proxy) \n    for details.\n\n* **2013-12-21 1.4.1**\n  * Background mode bugfix\n\n* **2013-12-21 1.4.0**\n  * Use configuration file;\n  * Support specify market\n  * Support manually set picture resolution\n  * Support downloading 1920x1080 images for pages without wallpaper link\n\n* **2013-09-24 1.3.0**\n  * supports high resolution wallpapers\n  * change default checking interval to 2 hours\n  * obsolete option `-f` and `--persistence`\n  * fix none type error when offset exceeds boundary issue #2\n  * fix none type error when download picture fails issue #3\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgenzj%2Fpybingwallpaper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgenzj%2Fpybingwallpaper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgenzj%2Fpybingwallpaper/lists"}