Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/luoling8192/bing-wallpaper-mac

Automatically update your macOS wallpaper with Bing's daily image.
https://github.com/luoling8192/bing-wallpaper-mac

bing-wallpaper macos wallpaper

Last synced: 16 days ago
JSON representation

Automatically update your macOS wallpaper with Bing's daily image.

Awesome Lists containing this project

README

        

# ๐Ÿ–ผ๏ธ Bing Wallpaper for macOS

Automatically update your macOS wallpaper with Bing's daily image.

## โœจ Features

- ๐Ÿ”„ Auto-updates wallpaper every hour
- ๐Ÿ–ผ๏ธ Downloads high-quality images from Bing
- ๐Ÿงน Supports multiple resolutions (4K, Full HD, HD)
- ๐Ÿ” Auto-detects screen resolution
- ๐Ÿงน Auto-cleans wallpapers older than 7 days
- โš™๏ธ Configurable settings
- ๐Ÿ’ช Lightweight and efficient
- โšก๏ธ Easy to install and use

## ๐Ÿš€ Installation

### Prerequisites

- macOS 10.12 or later
- [jq](https://stedolan.github.io/jq/) (JSON processor)
```bash
# Install using Homebrew
brew install jq

# Or using MacPorts
sudo port install jq
```

### Install

Simply run the script:
```bash
bash -c "$(curl -fsSL https://raw.githubusercontent.com/luoling8192/bing-wallpaper-mac/HEAD/install.sh)"
```

## ๐Ÿ—‘๏ธ Configuration

The script can be configured using the following commands:

```bash
# Run configuration wizard
bing_wallpaper --config

# View current settings
bing_wallpaper --show-config
```

Configuration options include:
- Resolution (Auto/4K/Full HD/HD)
- Auto-cleanup settings
- Wallpaper save location

## ๐Ÿ—‘๏ธ Uninstallation

To remove the app:
```bash
bash -c "$(curl -fsSL https://raw.githubusercontent.com/luoling8192/bing-wallpaper-mac/HEAD/uninstall.sh)"
```

## ๐Ÿ“ File Structure

- `bing_wallpaper.sh`: Main script for downloading and setting wallpaper
- `~/.wallpapers/`: Directory where wallpapers are stored
- `~/.config/bing-wallpaper/config`: Configuration file
- `~/Library/LaunchAgents/com.${USER}.bingwallpaper.plist`: LaunchAgent configuration

## ๐Ÿ“ Logs

Log files are stored in:
- `~/.wallpapers/bing_wallpaper.out`: Standard output
- `~/.wallpapers/bing_wallpaper.err`: Error messages

## ๐Ÿค Contributing

Feel free to submit issues and enhancement requests!

## ๐Ÿ“ License

MIT License - feel free to use and modify as you like!

## ๐Ÿ™ Acknowledgments

- Bing for providing beautiful daily images
- macOS community for inspiration

## ๐Ÿ’ก Tips

- The script runs hourly to check for new wallpapers
- Images are downloaded based on your screen resolution by default
- Each wallpaper includes a text file with its title and copyright information
- Old wallpapers are automatically cleaned up after 7 days (configurable)

---
Made with โค๏ธ for macOS users