Create with Hokucat

Make a wallpaper of your own.

Create a video with AI, or start with one of your own. Package it, then preview and apply it in Hokucat.

01 / CREATE

Start with a scene.

Give this prompt to Codex, Claude Code, or Grok Bot in an empty working folder. Change the setting, colors, or movement to suit your desktop. If you already have a video, skip to the next step.

Create an original 8-second desktop wallpaper called Quiet Tide. Use Python or FFmpeg to render a dark-blue horizon with soft moving reflections. Leave the top half quiet for desktop icons.

Use no downloaded assets, logos, characters, text, or audio. Make the motion periodic over exactly eight seconds and omit the duplicate end frame.

Export quiet-tide.mp4 as 1920 × 1080, 30 fps, H.264, yuv420p, with no audio track. Use FFprobe to report the codec, dimensions, duration, and streams. Check the transition from the last frame back to the first. Keep the source and video local.

AI helps with creation. Hokucat plays the finished media locally. The generated example is separate from the third-party PC works shown for testing in our previews. Authors and original pages.

02 / PACKAGE

Make an importable folder.

Download or clone the public Hokucat repository and open a terminal in its folder, or ask your coding assistant to run these steps there. You need Python 3 and FFmpeg, including ffprobe and the libx264 encoder.

To try the format first, run the public example with a new output folder. It generates an original eight-second video, a preview image, a fallback image, and the package information.

python3 examples/make-wallpaper.py "$HOME/quiet-tide"
Use your own video

Use a video you created or have permission to use and adapt. Replace the source path and credit below. The helper removes audio and makes the preview and fallback images from the video.

python3 examples/make-wallpaper.py "$HOME/my-wallpaper" --source ./quiet-tide.mp4 --attribution "Original video by Your Name"

The destination must be a new folder inside an existing directory. Existing files are not overwritten. Check the title, author, and source information before sharing your package.

This helper creates video packages. For a PNG/JPEG image package, follow the v1 manifest schema. View the public example.

03 / TRY

Preview it. Then make it your desktop.

  1. Open Wallpaper Dashboard in Hokucat, choose Import…, and select the whole package folder.
  2. Preview your wallpaper and check the fit. If you use more than one display, choose where to apply it.
  3. Click Apply Wallpaper. Watch at least two full loops to check the transition between the end and the beginning.

You can create a package now. Trying it on the desktop requires an installed Hokucat review build; the public installer is not yet available. Preview updates.

What Package v1 supports.

Still images

PNG or JPEG, with a preview and a fallback image.

Silent video loops

MP4, MOV, or M4V, played from local files.

This import format does not run general interactive Web or Windows Scene projects, receive live pointer or audio input, or connect to APIs or agents. Selected built-in or adapted wallpapers may have their own interactive features.

Inside the package
quiet-tide/
├── manifest.json
├── media/
│   ├── loop.mp4
│   ├── preview.png
│   └── still.png
└── rights/
    └── assets.json

Keep manifest.json at the top level. It names the wallpaper, author, media, and rights file. The preview appears in the library; the fallback is a still image available if the video cannot play.

Record the attribution and usage, adaptation, and distribution permissions for each distinct media file in rights/assets.json. Local import requires usage: true. Keep distribution: false if redistribution permission is unconfirmed. A valid manifest alone does not prove that the media plays correctly; check the finished package in Hokucat.

Share your wallpaper

Share a preview and how you made it. Prompts, scripts, or a package are welcome too. You can share before trying it in Hokucat—just tell us what you have tested.

Share on GitHub

用 Hokucat 创作

做一张自己的壁纸

用 AI 创作一段视频,或从自己的视频开始。打包后,在 Hokucat 里预览和应用。

01 / 创作

先想一个画面

在空白工作文件夹里,把这段提示词交给 Codex、Claude Code 或 Grok Bot。可以修改场景、颜色和运动方式,让它更适合你的桌面。如果已有视频,直接进入下一步。

创作一段名为 Quiet Tide 的 8 秒原创桌面壁纸。用 Python 或 FFmpeg 绘制深蓝色地平线与缓慢移动的柔光倒影,画面上半部分留白,方便放桌面图标。

不使用下载素材、标志、角色、文字或音轨。所有动作以 8 秒为周期,去掉重复的最后一帧。

导出 quiet-tide.mp4,规格为 1920 × 1080、30 fps、H.264、yuv420p,无音轨。用 FFprobe 检查编码、尺寸、时长和媒体流,并检查结尾回到开头的循环接缝。源文件和视频保留在本机。

AI 参与创作,Hokucat 在本机播放完成后的素材。本教程生成的示例与预览中仅供测试的第三方 PC 作品分开署名,详见作者与原作页面。

02 / 打包

生成可以导入的文件夹

下载或克隆 Hokucat 公开仓库,在该文件夹中打开终端,也可以让编程助手在这里执行下面的步骤。需要 Python 3 和 FFmpeg,包含 ffprobe 与 libx264 编码器。

想先试一下格式,可以用一个尚未使用的文件夹名运行公开示例。它会生成 8 秒原创视频、预览图、回退图和作品信息。

python3 examples/make-wallpaper.py "$HOME/quiet-tide"
使用自己的视频

使用自己制作或获准使用、改编的视频,把下方的素材路径与作者署名换成真实信息。脚本会移除音轨,并从视频生成预览图和回退图。

python3 examples/make-wallpaper.py "$HOME/my-wallpaper" --source ./quiet-tide.mp4 --attribution "原创视频,作者填这里"

输出位置必须是已有目录下的一个新文件夹,脚本不会覆盖已有文件。分享作品包前,请核对标题、作者和素材来源信息。

这个脚本生成视频作品包。PNG/JPEG 图片作品包请参照 v1 清单规范。查看公开示例。

03 / 试用

先预览,再放到桌面

  1. 在 Hokucat 中打开壁纸面板,选择导入…,选中整个作品包文件夹。
  2. 预览画面,检查显示效果。如果连接了多块显示器,选择想要应用的屏幕。
  3. 点击应用壁纸。至少连续看两遍循环,确认结尾回到开头时自然衔接。

你现在就可以制作作品包。在桌面试用需要已安装 Hokucat 审阅版;公开安装包暂未开放下载。查看发布状态。

作品包 v1 支持什么

静态图片

PNG 或 JPEG,带预览图和回退图。

静音循环视频

MP4、MOV 或 M4V,在本机播放。

此导入格式暂不支持通用交互式 Web、Windows Scene 工程、实时鼠标或音频输入,也不连接 API 或 Agent。部分内置或单独适配的壁纸可以有各自的互动能力。

作品包里有什么
quiet-tide/
├── manifest.json
├── media/
│   ├── loop.mp4
│   ├── preview.png
│   └── still.png
└── rights/
    └── assets.json

manifest.json 放在文件夹顶层,记录作品名称、作者、媒体与授权文件。预览图用于壁纸库,回退图用于视频无法播放时的静态画面。

在 rights/assets.json 中为每个不同的素材文件记录署名,以及使用、改编和分发权限。本机导入要求 usage: true;尚未确认再分发许可时,保持 distribution: false。清单格式正确不等于素材一定能正常播放,完成后仍需在 Hokucat 中检查。

分享你的壁纸

分享预览和创作方法
也欢迎附上提示词、脚本或作品包
还没在 Hokucat 里试过也可以 请注明当前进度

在 GitHub 分享