navig-generate

Generate images, video and audio with your own provider keys, keep the variants you like, and edit them: cut, fx, beats, tonality, sprites. Runs on its own as navig-generate; the shared media engine lives in navig-media-core.

Works on its own — its own CLI, no navig required · v0.4.1 · PyPI

On its own (no navig needed)

pip install navig-generate
navig-generate --help   # no navig needed

With navig

pip install "navig[generate]"

NAVIG Generate: make images, video and audio with your own provider keys, keep the variants you like, and edit them. It owns the generation service, the generator clients, beats, tonality and the sprite pipeline; the shared foundation it and navig run on (video cut/fx/captions, audio edit, refs library, variant store, provider catalog) is navig-media-core, which this package depends on.

On its own

pip install navig-generate                # adds the `navig-generate` command
export OPENAI_API_KEY=…                   # or RECRAFT_API_KEY, GEMINI_API_KEY, STABILITY_API_KEY…
navig-generate gen "a red fox, flat vector" --provider openai_gpt_image
navig-generate list                       # short ids; every command accepts them
navig-generate keep 8ab12f25
pip install "navig-generate[process]"     # Pillow: process / palette / contact-sheet
pip install "navig-generate[beats]"       # numpy: beat and tonality detection

Variants land in the project you stand in (<nearest folder with .navig/>/.navig/refs, else the current folder) and are recorded in <data dir>/generated_media.db — the same library navig reads, so nothing moves when you install navig later. Keys come from the environment or the shared encrypted vault (navig-vault). ffmpeg must be on PATH for video and audio edits.

Inside navig

The same commands are navig generate … (next to navig's analyse/briefing commands), and the deck's media screens use this engine. navig's old paths stay identity aliases: navig.media.{generation_service,beats,tonality,processing} and navig.tools.{image,video,audio}_generation from this package, the rest (navig.media.{types,refs_library,…}, navig.tools.media_providers) from navig-media-core. Deck screens need navig.

Wallpapers — navig generate wallpaper

The display half of generation. gen puts a variant in the refs library for review; this group puts an image on a monitor, at that monitor's exact pixel size. Same engine, different destination — which is why it is a group under generate and not a separate plugin.

navig generate wallpaper                           # displays, current image/style, deps
navig generate wallpaper screens                   # exact pixel size per display
navig generate wallpaper generate "a city under a red hexagonal grid" --n 2 --pick 1
navig generate wallpaper set art.png --mode blur   # keep a portrait whole
navig generate wallpaper make art.png --width 3440 --height 1440 -o wall.png
navig generate wallpaper style fit | fill | span | center | stretch | tile
navig generate wallpaper restore                   # back to the previous one (toggles)
pip install "navig-generate[wallpaper]"            # Pillow + numpy

Why it composes instead of handing Windows the render: Windows crops a mismatched image blindly, usually through the subject. --mode cover crops deliberately, blur keeps the whole image over a blurred bed, contain letterboxes on the image's own edge colour; then it sharpens only what the upscale softened, adds grain (kills 8-bit banding on big dark gradients), a 10% vignette, an optional --sky 0.42 falloff toward near-black navy, and an optional corner mark (--mark <png> --mark-corner br --mark-height 135).

Setting is SystemParametersInfoW(SPI_SETDESKWALLPAPER) — writing HKCU\Control Panel\Desktop\Wallpaper alone leaves the running session on the old image until sign-out, and re-saving to the same path is invisible for the same reason. The verb also pins the fit style and clears BackgroundType so a leftover Spotlight/Photos slideshow cannot override it. Windows-only: make still composes anywhere, and says which size it used.

Files land in <data dir>/wallpapers/ with index.json tracking active/previous; the composed file you pass with -o is used in place instead.

A wallpaper that rotates itself

Set a prompt and a cadence once; navig generates a fresh wallpaper on that schedule.

navig generate wallpaper schedule --prompt "a city under a red hexagonal grid" --every day --at 07:30
navig generate wallpaper schedule --every week --at 06:00      # Mondays
navig generate wallpaper schedule --every off                  # stop rotating
navig generate wallpaper schedule                              # what is set, and the live job
navig generate wallpaper tick                                  # rotate once, now

The settings live in navig's config (generate.wallpaper.*: prompt, cadence, time, display, style, mode, mark, candidates) so the CLI and NAVIG OS read the same values. The job is a plain navig cron job (navig cron list shows wallpaper-rotate), and it runs one fixed command — navig generate wallpaper tick — so changing the prompt never re-registers it.

Where navig is not on PATH for the daemon, the job is registered in the runnable form (cron's NAVIG_EXEC: prefix, absolute interpreter) instead of failing at fire time.

OS surface — the settings card talks to three deck routes: