haoyuqi/download-bing-wallpaper

Download Bing Wallpaper

A Laravel 13 package that retrieves Bing wallpaper metadata for an exact date and writes one versioned JSON document to standard output. It never downloads or saves an image, and it never substitutes another date.

Requirements

Installing a package update does not upgrade PHP. The command is CLI-only and does not start sessions, but web applications that run on the same PHP runtime should set session.upload_progress.enabled=0 until the next PHP bugfix release, which fixes the separate CVE-2026-115560.

Installation

composer require haoyuqi/download-bing-wallpaper

Usage

php artisan bing:wallpaper --date=2026-08-31 --no-ansi

The --date option is required and must be a real calendar date in YYYY-MM-DD format. The command requests Bing's fixed en-US source, searches its current eight-item response for that exact date, and writes exactly one JSON document followed by a newline. Standard error stays empty.

Output

The data object contains sourceDate, sourceItemId, title, copyright, copyrightLink, imageUrl and downloadUrl. sourceItemId is Bing's 32-character hash when valid, otherwise a deterministic sha256:v1:... value. Links are absolute HTTPS URLs restricted to Bing hosts.

{
  "schemaVersion": "1.0",
  "status": "found",
  "query": {
    "source": "bing",
    "market": "en-US",
    "date": "2026-08-31"
  },
  "data": {
    "sourceDate": "2026-08-31",
    "sourceItemId": "abcdef0123456789abcdef0123456789",
    "title": "A title",
    "copyright": "A place — Photographer",
    "copyrightLink": "https://www.bing.com/search?q=example",
    "imageUrl": "https://www.bing.com/th?id=example_1920x1080.jpg",
    "downloadUrl": "https://www.bing.com/th?id=example_UHD.jpg"
  },
  "rawPayload": {
    "images": [
      {
        "startdate": "20260831",
        "url": "/th?id=example_1920x1080.jpg"
      }
    ]
  },
  "error": null,
  "retrievedAt": "2026-08-31T00:00:00Z"
}

error.code is stable; current values are DATE_REQUIRED, INVALID_DATE, CONNECTION_FAILED, UPSTREAM_TIMEOUT, UPSTREAM_REDIRECT, UPSTREAM_RATE_LIMITED, UPSTREAM_REQUEST_REJECTED, UPSTREAM_UNAVAILABLE, UPSTREAM_RESPONSE_TOO_LARGE, INVALID_UPSTREAM_JSON, INVALID_UPSTREAM_SCHEMA and UNEXPECTED_ERROR.

Exit codes

Development

composer check
php -d pcov.enabled=1 -d pcov.directory=src vendor/bin/phpunit \
    --coverage-clover build/coverage.xml --coverage-text

composer check runs manifest validation, optimized autoloading, Larastan, Pint and PHPUnit. Tests use faked HTTP responses and never contact Bing. CI requires exactly 100% executable line coverage across src/, including files no test loads.

Questions and reproducible bugs belong in GitHub issues; report vulnerabilities privately as described in SECURITY.md.

Release

Push a vX.Y.Z or X.Y.Z tag on a commit reachable from master. The release workflow validates the tag, runs tests and quality checks, generates bilingual notes, and publishes only when every check passes. A manual dispatch only previews the notes; an existing release is never rewritten.

License

Project code is licensed under the MIT license.