{"id":18716581,"url":"https://github.com/timothyye/bing-wallpaper","last_synced_at":"2025-05-16T00:09:03.465Z","repository":{"id":35128138,"uuid":"158163776","full_name":"TimothyYe/bing-wallpaper","owner":"TimothyYe","description":"A RESTful API to fetch daily wallpaper from Bing.com","archived":false,"fork":false,"pushed_at":"2025-05-01T09:37:47.000Z","size":2923,"stargazers_count":404,"open_issues_count":1,"forks_count":37,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-05-16T00:08:46.025Z","etag":null,"topics":["bing-wallpaper","bing-wallpaper-api"],"latest_commit_sha":null,"homepage":"https://bing.biturl.top/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TimothyYe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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,"zenodo":null},"funding":{"github":"TimothyYe","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2018-11-19T04:53:14.000Z","updated_at":"2025-05-12T16:57:36.000Z","dependencies_parsed_at":"2024-01-17T00:18:24.100Z","dependency_job_id":"74523203-515d-4ce0-933d-5727fbdad287","html_url":"https://github.com/TimothyYe/bing-wallpaper","commit_stats":{"total_commits":57,"total_committers":9,"mean_commits":6.333333333333333,"dds":"0.26315789473684215","last_synced_commit":"41d980942a9d47fa33c87951c3ab1590ba074ac5"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TimothyYe%2Fbing-wallpaper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TimothyYe%2Fbing-wallpaper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TimothyYe%2Fbing-wallpaper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TimothyYe%2Fbing-wallpaper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TimothyYe","download_url":"https://codeload.github.com/TimothyYe/bing-wallpaper/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254442856,"owners_count":22071878,"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":["bing-wallpaper","bing-wallpaper-api"],"created_at":"2024-11-07T13:13:07.360Z","updated_at":"2025-05-16T00:08:58.440Z","avatar_url":"https://github.com/TimothyYe.png","language":"Go","funding_links":["https://github.com/sponsors/TimothyYe"],"categories":[],"sub_categories":[],"readme":"## Bing Wallpaper API\n\nA RESTful API to fetch daily wallpaper from Bing.com\n\n## Usage\n\n### API \n* API Address: [https://bing.biturl.top](https://bing.biturl.top/)\n* Method: `HTTP GET`\n\n### Parameters\n\n* `format` The response format, can be `json` or `image`. __If response format is set as `image`, you will be redirected to the wallpaper image directly__.\n* `image_format` The format of the wallpaper image, available values are `jpg` or `webp`. The default value is `jpg`.\n* `index` The index of wallpaper, starts from 0. By default, `0` means to get today's image, `1` means to get the image of yesterday, and so on. Or you can specify it as `random` to choose a random index between 0 and 7.\n* `mkt` The region parameter, the default value is `zh-CN`, you can also use `en-US`, `ja-JP`, `en-AU`, `en-GB`, `de-DE`, `en-NZ`, `en-CA`, `en-IN`, `fr-FR`, `fr-CA`, `it-IT`, `es-ES`, `pt-BR`, `en-ROW`. Alternatively, you can set it as `random` to choose the region randomly.\n* `resolution` The resolution of wallpaper image. `1920` is the default value, you can also use `1366` and `3840` or `UHD` (4K resolution).\n\nThe available resolution options are listed below:\n```\nUHD\n1920x1200\n1920x1080\n1366x768\n1280x768\n1024x768\n800x600\n800x480\n768x1280 (Portrait mode)\n720x1280 (Portrait mode)\n640x480\n480x800 (Portrait mode)\n400x240\n320x240\n240x320 (Portrait mode)\n```\n\n### Example\n\n* Request\n\n```text\nhttps://bing.biturl.top/?resolution=UHD\u0026format=json\u0026index=0\u0026mkt=zh-CN\n```\n\n* Response\n\n```json\n{\n\"start_date\": \"20240803\",\n\"end_date\": \"20240804\",\n\"url\": \"https://www.bing.com/th?id=OHR.ImpalaOxpecker_ZH-CN9652434873_UHD.jpg\",\n\"copyright\": \"黑斑羚和红嘴牛椋鸟，南非 (© Matrishva Vyas/Getty Images)\",\n\"copyright_link\": \"https://www.bing.com/search?q=%E5%8F%8B%E8%B0%8A%E6%97%A5\u0026form=hpcapt\u0026mkt=zh-cn\"\n}\n```\n\n### CSS background image\n\nYou can also use this API to set CSS background image:\n\n```text\nbackground-image: url(https://bing.biturl.top/?resolution=1920\u0026format=image\u0026index=0\u0026mkt=zh-CN);\nheight: 100%;\nbackground-position: center;\nbackground-repeat: no-repeat;\nbackground-size: cover;\n```\n\n__Demo__  \n\n[https://biturl.top](https://biturl.top)\n\n![https://github.com/TimothyYe/biturl/blob/master/screenshots/1.jpg?raw=true](https://github.com/TimothyYe/biturl/blob/master/screenshots/1.jpg?raw=true)\n\n## Run with docker\n\nGet the latest version of docker image:\n\n```bash\ndocker pull timothyye/bing:latest\n```\n\nStart the container with the image name \u0026 tag (YYYYMMDD or latest), for example:\n\n```bash\ndocker run -d --name=bing-wallpaper --restart=always -p 9000:9000 timothyye/bing:latest\n```\n\n## For development\n\n### Build it\n```bash\ngit clone https://github.com/TimothyYe/bing-wallpaper.git\nmake build\n```\n\n### Run it\n\n```bash\nbw/bw run\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimothyye%2Fbing-wallpaper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftimothyye%2Fbing-wallpaper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimothyye%2Fbing-wallpaper/lists"}