← Back to Portfolio

BootPaper

Randomized wallpaper on boot for the GNOME desktop environment on Linux.

Type

GNOME Shell Extension

Release Year

2025

Status

Active

Compatibility

GNOME 45+

About This Extension

BootPaper is a simple GNOME Shell extension that automatically selects and sets a random wallpaper from your chosen local directory.

The extension was designed for people like me that have too many favorite wallpapers but don't like slideshows. just set your wallpaper folder in the settings, and BootPaper takes care of the rest at every booting.

Technologies Used

JavaScript GNOME Shell GJS Linux
BootPaper Extension Icon

Key Features

Automatic Rotation

Set a folder containing your favorite wallpapers, and BootPaper will randomly select one at each system boot and login.

Simple Configuration

Easy-to-use settings panel where you can specify your wallpaper directory.

Lightweight & Fast

Minimal resource usage, after boot the extension disable itself until the next startup.

Installation & Setup

1

Install from GNOME Extensions

Visit the official GNOME Extensions website and click the install button. The extension will be automatically downloaded and installed.

Get it on GNOME Extensions
2

Configure Your Wallpaper Folder

Open the extension settings and select the folder containing your wallpaper collection. This is required for the extension to work.

3

Reboot and Enjoy

Restart your system and watch as BootPaper automatically sets a random wallpaper from your collection. A new wallpaper awaits you at every boot!

Important to Know

The wallpaper will change after a 3-second wait after startup. This delay ensures that the desktop environment is fully loaded before applying the new wallpaper, preventing any potential conflicts or visual glitches.

Open Source & Contributing

BootPaper is my first GNOME Shell extension, and I'm always looking to improve it! Contributions are more than welcome, whether it's bug fixes, new features, or documentation improvements.

How to Contribute

  1. Fork the repository on GitHub
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Commit Message Guidelines

  • Start with a capital letter
  • Use present tense (e.g., "Add feature" not "Added feature")

License

This project is distributed as is without any warranty under the GNU General Public License v2.0.

View License →

Support BootPaper

BootPaper is provided free of charge. If you enjoy using this extension and wish to help support the creator and the project, feel free to send a coffee my way!

Support on Ko-fi