https://github.com/joshau-04/wallctl

🖼 Wallpaper utility and downloader
https://github.com/joshau-04/wallctl

blazingly-fast command-line utility wallpaper

Last synced: about 6 hours ago
JSON representation

🖼 Wallpaper utility and downloader

• Host: GitHub
• URL: https://github.com/joshau-04/wallctl
• Owner: JoshAU-04
• License: gpl-2.0
• Created: 2024-12-21T08:59:09.000Z (about 2 months ago)
• Default Branch: main
• Last Pushed: 2025-01-14T13:19:32.000Z (24 days ago)
• Last Synced: 2025-01-14T14:30:02.542Z (23 days ago)
• Topics: blazingly-fast, command-line, utility, wallpaper
• Language: Python
• Homepage: https://pypi.org/project/wallctl/
• Size: 26.4 KB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# wallctl

## About

Wallctl is a program that is originally inspired by [4k-wallpaper-downloader](https://github.com/hosseinmirhosseini76/random-4k-image-downloader).

The project is also available on [pypi](https://pypi.org/project/wallctl).

## Installation

1. Clone the repository

```bash

git clone --depth 1 https://github.com/JoshAU-04/wallctl

cd wallctl

```

2. Install locally

```bash

pip install .

```

Alternatively, for development purposes:

```bash

pip install -e .

```

### Pipx

For MacOS and Linux users, install the project directly with pipx:

```bash

pipx install wallctl

```

## Usage

### Show available commands

```bash

wallctl --help

```

### Download a random wallpaper

```bash

wallctl random

```

### Download a wallpaper by category

```bash

wallctl category --category 

```

### Download a wallpaper to a specific directory

```bash

wallctl random --path 

```

## License

This project is licensed under the GNU GPL (v2). Refer to the `LICENSE` file

for the full license.