{"id":16902240,"url":"https://github.com/keystroke3/redpaper","last_synced_at":"2025-04-12T15:50:26.770Z","repository":{"id":36750899,"uuid":"179813098","full_name":"keystroke3/redpaper","owner":"keystroke3","description":"A tool to download and set desktop wallpapers from Reddit","archived":false,"fork":false,"pushed_at":"2024-07-06T10:40:04.000Z","size":360,"stargazers_count":69,"open_issues_count":1,"forks_count":9,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-26T10:21:10.843Z","etag":null,"topics":["desktop","linux","looks","personalization","python","python3","reddit","style","theme","themeing","wallpaper"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/keystroke3.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2019-04-06T09:24:28.000Z","updated_at":"2025-03-25T19:38:21.000Z","dependencies_parsed_at":"2024-07-06T11:55:54.650Z","dependency_job_id":null,"html_url":"https://github.com/keystroke3/redpaper","commit_stats":{"total_commits":121,"total_committers":5,"mean_commits":24.2,"dds":"0.23140495867768596","last_synced_commit":"eb3c29458fa8bb8066cc9ff882e85c8184b77445"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keystroke3%2Fredpaper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keystroke3%2Fredpaper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keystroke3%2Fredpaper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keystroke3%2Fredpaper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/keystroke3","download_url":"https://codeload.github.com/keystroke3/redpaper/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248591877,"owners_count":21130139,"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":["desktop","linux","looks","personalization","python","python3","reddit","style","theme","themeing","wallpaper"],"created_at":"2024-10-13T18:04:21.540Z","updated_at":"2025-04-12T15:50:26.743Z","avatar_url":"https://github.com/keystroke3.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Redpaper\n## Overview\nRedpaper is a simple tool that is used to download and set new wallpapers.  \nIt gets the images from reddit.com.  \n\nIf you frequently search for, download and set wallpapers, or like to give you system  \na new look, you this tool is for you.  When you want to change the wallpaper, you simply  \nrun Redpaper's download tool and it will scout Reddit for the best wallpaper of the  \nday and download them. You can then change the wallpaper using it.\n\n![Main Menu](https://raw.githubusercontent.com/keystroke3/redpaper/master/screenshots/neo-redpaper.png)\n\n## Installation\nIf you are running Arch or Arch-based distro, you can install from aur:\n`yay -S redpaper-git`\n\nRedpaper only works on Linux systems at the moment, therefor only people running Linux  \ncan use it.  \n### Dependencies\n* Python 3.6 or later  \n* Python3-pip  \n* Requests  \n* Pillow  \n* PyGObject  \n* [xwallpaper](https://github.com/stoeckmann/xwallpaper) (only if you use tiling window managers)\n\nPython3 should come by default on a Linux system, but if you are not sure if it is installed,  \nyou can run  `python3` in your terminal. If you get no errors, then you can proceed. If you  \nget an error, you should  visit python.org to get it.  \nPip comes by default with Python. If for some reason you don't have it, you can run:  \n```curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py```  \nand then  \n```python get-pip.py```\nThe other dependencies will be automatically installed.  \n### Procedure\nWhen the first two dependencies have been met, you can run the following command to do the install:  \n```git clone https://github.com/keystroke3/redpaper.git \u0026\u0026 cd redpaper \u0026\u0026 sudo sh install.sh```\n\n#### Tiling window managers\nIf you are running a tiling window manager like i3, bspwm etc.. you will need to add this to your  \nautostart files e.g. ~/.config/bspwm/bspwmrc if you are using bspwm:  \n```$HOME/.redpaper/wallapaper.sh```  \nThis line makes sure that the wallpaper you set will persist after logging in. \n## Usage\nTo use, simply run `redpaper` in the terminal.\nOnce the installation is complete, you can use Redpaper in two ways, with command mode and with  \nand with interactive shell.\n\n### Interactive mode (TUI)\nYou can also run redpaper in interactive mode, that does not involve typing commands.  \nTo actaivate this mode, simply run redpaper without any arguments to bring it up.  \n\n\n### Command Line Mode (CLI)\nYou can run the redpaper command with arguments to perform tasks. You can also pass a file name, folder name or list of folder names that contain images, in the form `redpaper FILE` `redpaper FOLDER1, FOLDER2...`\nThe list of arguments can be\nlisted by running `redpaper -h` or `redpaper --help`\n\n## Options\n| flag | name  | Descritpion \n|-|-|-|\n| -d | --download | Downloads new wallpapers\n|  -c | --change | sets the next image in list as wallapper. Sets the first one in the list after a the list has been updated or at EOL\n|  -b | --back | Sets the previous image in the list as wallpaper\n|  -a | --all | Download new wallpapers and set the first one\n|  -l | --limit LIMIT |  Number of wallpapers to look for. This is *not* the number of file that will be downloaded. A check is done to make sure the images are 16:9 aspect ratio or close to it. Default = 5\n|  -p | --path PATH | Sets the download location for new wallpapers. \n|  -i | --image IMAGE | Sets a specified image as wallpaper. \n|  -r | --sub STRING |Sets a user specified subreddit(s) as source \n|  -f |  --folder [FOLDER ...] | Uses images stored in the specified folder. Multiple folders can be added \n|  -s | --settings | change settings permanently. Use this in combination with other modifier flags to make them modifications permanent. E.g. `redpaper -sl 10` will set the look up limit to 10.\n  \n\nKeep in mind that  settings will be ignored when the alternative value is passed as an argument in command mode.  \nThe behavior of the program can be slightly modified by the user. Currently, there are only  \n a few changes that can be made. The settings are:\n\n## Contributions\nAll input and contibutions are welcome. If you have a feature you want, you can ask for it in the issues tab. If you can help improve the code and add the feature, then fork the repo and create a pull request.\n\n[Leagal stuff](https://github.com/keystroke3/redpaper/blob/master/LEAGAL.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkeystroke3%2Fredpaper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkeystroke3%2Fredpaper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkeystroke3%2Fredpaper/lists"}