WPFS is a FUSE-based filesystem that provides dynamic access to wallpapers. It supports multiple backends including local files and wallhaven.cc API integration.

• FUSE-based filesystem implementation
• Multiple backend support:
  • Any HTTP server with an image endpoint
  • Wallhaven.cc API integration
• Dynamic file generation

• Go 1.24.0 or later
• FUSE kernel module installed
• Wallhaven.cc API key (if using the wallhaven backend)

go install github.com/gqgs/wpfs@latest

The core FUSE filesystem implementation that presents images as files in your filesystem.

Environment variables:

• WPFS_MOUNTPOINT: Directory where the filesystem will be mounted
• WPFS_FILE_SERVER: Endpoint of the file server to fetch images from

Integration with wallhaven.cc API to fetch random wallpapers.

Environment variables:

• WPFS_WALLHAVEN_API_KEY: Your wallhaven.cc API key
• Default port: 9999
• Default resolution: 3840x2160
• Default aspect ratio: 16x9

1. Start the desired backend server:

   For wallhaven:

   export WPFS_WALLHAVEN_API_KEY=your_api_key
   go run ./cmd/wallhaven

2. Mount the filesystem:

   export WPFS_MOUNTPOINT=/path/to/mount
   export WPFS_FILE_SERVER=http://localhost:9999
   go run ./cmd/fs

3. Access your wallpapers through the mount point:

   ls /path/to/mount