59 lines
2.2 KiB
Markdown
59 lines
2.2 KiB
Markdown
|
[](/LICENSE)
|
||
|
|
[](https://fishshell.com)
|
||
|
|
[](https://www.github.com/oh-my-fish/oh-my-fish)
|
||
|
|
|
||
|
|
# uc
|
||
|
|
|
||
|
|
> A plugin for [Oh My Fish](https://www.github.com/oh-my-fish/oh-my-fish)
|
||
|
|
|
||
|
|
uc (unsplash collections) allows one to list photo collections on unsplash from where to draw a wallpaper at random.
|
||
|
|
|
||
|
|
## Options
|
||
|
|
|
||
|
|
```
|
||
|
|
uc [collection number]
|
||
|
|
Get a random image from a collection and set it as the new background and screensaver wallpaper. If no collection is specified, a random listed collection will be used instead.
|
||
|
|
|
||
|
|
uc -a/--add [collection number] ...
|
||
|
|
Add a new collection to the list.
|
||
|
|
|
||
|
|
uc -r/--remove [collection number] ...
|
||
|
|
Remove a collection from the list.
|
||
|
|
|
||
|
|
uc -u/--url [collection number] ...
|
||
|
|
Present the urls from specified collections.
|
||
|
|
|
||
|
|
uc -f/-folder [directory]
|
||
|
|
Set where images are stored. If no directory is passed, display where they're currently being stored.
|
||
|
|
|
||
|
|
uc -c/--cache [number]
|
||
|
|
Set the size of the image cache.
|
||
|
|
|
||
|
|
uc -l/--list [collection/size/description]
|
||
|
|
Show listed collections.
|
||
|
|
|
||
|
|
uc -h/--help
|
||
|
|
Display these instructions.
|
||
|
|
```
|
||
|
|
|
||
|
|
## Install
|
||
|
|
|
||
|
|
```fish
|
||
|
|
omf repositories add https://gitlab.com/argonautica/argonautica
|
||
|
|
omf install uc
|
||
|
|
```
|
||
|
|
|
||
|
|
### Dependencies
|
||
|
|
|
||
|
|
This plugin uses [unsplash_wallpaper](https://github.com/cuth/unsplash-wallpaper) by [cuth](https://github.com/cuth) to get wallpapers. If you don't have it installed, you'll be prompted to install it upon installing of this plugin.
|
||
|
|
|
||
|
|
## Configuration
|
||
|
|
|
||
|
|
This script is optimized to work with environment variables available to [cron](https://en.wikipedia.org/wiki/Cron), so that you can change your background and lockscreen wallpapers periodically and automatically. As an example, to change them every 3 hours, use the command `crontab -e` and append the following line:
|
||
|
|
|
||
|
|
```
|
||
|
|
0 */3 * * * .local/share/omf/pkg/uc/functions/uc.fish
|
||
|
|
```
|
||
|
|
|
||
|
|
For more information on how to schedule tasks using cron, consult this [video](https://www.youtube.com/watch?v=8j0SWYNglcw).
|