Skip to content

Conversation

@EmiFree
Copy link
Contributor

@EmiFree EmiFree commented Nov 30, 2025

Added documentation for hyprpaper, a wallpaper utility for Hyprland, including usage instructions and commands.

Checklist

  • The page(s) are in the correct platform directories: common, linux, osx, windows, sunos, android, etc.
  • The page description(s) have links to documentation or a homepage.
  • The page(s) follow the content guidelines.
  • The page(s) follow the style guide.
  • The PR contains at most 5 new pages.
  • The PR is authored by me, or has been human-reviewed if it was created with AI or machine translation software.
  • The PR title conforms to the recommended templates.
  • Version of the command being documented (if known):
  • Reference issue: #

Added documentation for hyprpaper, a wallpaper utility for Hyprland, including usage instructions and commands.
@github-actions github-actions bot added new command Issues requesting creation of a new page or PRs adding a new page for a command. review needed Prioritized PRs marked for reviews from maintainers. labels Nov 30, 2025
@tldr-bot

This comment was marked as resolved.

Copy link
Member

@Managor Managor left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Other than this, this looks good to go.

Copy link
Collaborator

@ivanbaluta ivanbaluta left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have a question regarding dynamic usage. Does hyprctl hyprpaper preload /path/to/image work as expected, or is preloading only possible via the config file?
If the CLI command works, I think it's a very important command that should be added here.

EmiFree and others added 3 commits November 30, 2025 00:04
further looked into and tested other commands and made new examples for preload and reload
@EmiFree
Copy link
Contributor Author

EmiFree commented Nov 30, 2025

I have a question regarding dynamic usage. Does hyprctl hyprpaper preload /path/to/image work as expected, or is preloading only possible via the config file? If the CLI command works, I think it's a very important command that should be added here.

Thank you for pointing that out, I guess I missed that. I reviewed the documentation and tested on my own, and updated the md file with a working example using preload.

@ivanbaluta
Copy link
Collaborator

Thanks for testing and updating!
However, I suspect there might be a syntax error regarding the arguments, specifically the {{monitor}} part.

  1. Preload syntax: Since preload loads the image into RAM globally (not for a specific screen), it usually only takes the file path. The config syntax is just preload = /path/to/img.
    Shouldn't the command be:
    hyprctl hyprpaper preload "{{path/to/image.png}}"
  2. Reload command: Does hyprctl hyprpaper reload actually accept arguments like monitor and image?

Could you please double-check the exact syntax for these two commands

Updated the command for preloading wallpaper to remove monitor specification.
@EmiFree
Copy link
Contributor Author

EmiFree commented Nov 30, 2025

You are right, I must have gotten preload and reload mixed up. Preload only accepts an image path, but reload accepts a monitor and an image path.

@ivanbaluta
Copy link
Collaborator

Thanks for your contribution!

@ivanbaluta ivanbaluta merged commit 0f7da73 into tldr-pages:main Dec 2, 2025
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

new command Issues requesting creation of a new page or PRs adding a new page for a command. review needed Prioritized PRs marked for reviews from maintainers.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants