Help — vxKite

Help

vxKite's full manual comes with the app, and in vxKite, ? shows every key and typed command on one panel. Here: every kind of file it opens, how to remove it, and what to send when something goes wrong. Questions: support@vxkite.com.

What vxKite opens

112 file extensions as of 0.99.7 (unchanged since 0.98.97), every one on both the Mac and Windows unless it says otherwise, plus a few kinds known by their name or their content (below). Nothing is fetched from the internet to open any of them, and no script a file carries is ever run (a three.js scene's shaders run only to draw it, on the graphics card).

By extension

Family	Extensions	How it shows
Documents	`.pdf`	Pages: zoom, rotate, callouts, ink, stickers, Find, the Pages tools
Office	`.docx` `.xlsx` `.pptx` `.odt` `.ods` `.odp` `.doc` `.xls` `.ppt` `.rtf`	Converted to a PDF on the computer; a stickered exhibit can also be saved as the Office file itself
Pictures	`.png` `.jpg` `.jpeg` `.jfif` `.gif` `.webp` `.bmp` `.avif` `.ico` `.heic` `.heif` `.tif` `.tiff` `.svg`	One page (a multi-page TIFF as pages); EXIF and GPS in INFO — a phone's photo as an iPhone or an Android writes it: JPEG (a Motion Photo's or an Ultra HDR's trailer after it), HEIC and HEIF, AVIF, and WebP's EXIF chunk; a GPS photo lands on a media map by it; a tagged 360 on the sphere; an SVG's layers
Camera RAW	`.dng` `.cr2` `.cr3` `.nef` `.arw` `.orf` `.rw2` `.raf`	By the camera's own picture of the shot (the largest it kept, turned as it says); the sensor data is not developed; its GPS and time read (a phone's DNG, a Canon CR3's own boxes)
JPEG 2000	`.jp2` `.j2k` `.j2c` `.jpx` `.jpf`	A page, through pdf.js's own decoder
Studio files	`.psd` `.psb` `.kra` `.ora` `.ai` `.ase` `.aseprite`	The flattened picture (an Aseprite's frames play, its layers switch); a PDF-compatible Illustrator file as a PDF
Medical	`.dcm` `.dicom` `.dic` `.ima` `.nii` `.gii` `.edf` `.bdf`	DICOM series (X-rays, CT, MR, dental films; a loop plays); NIfTI brain volumes in three planes with an activation heat map, a 4D run over time; GIfTI brain surfaces in 3D; EEG and ECG traces — not for diagnostic use
Video	`.mp4` `.m4v` `.webm` `.mov` `.3gp` `.3g2`	The player: markers, segments, captions, a synced deposition; a 360 video on the sphere; where it was recorded (a phone's `©xyz`, Apple's location key, 3GPP's `loci`)
Audio	`.mp3` `.wav` `.m4a` `.m4b` `.aac` `.flac` `.ogg` `.oga` `.opus` `.weba` `.aiff` `.aif` `.caf`	The player with the cover and tags; an album, a library (AIFF and CAF on the Mac)
Books and comics	`.epub` `.cbz` `.cbr` `.cbt`	A book, scrolled or paged; a comic's pages and the Action Reader
Text and data	`.txt` `.md` `.markdown` `.json` `.xml` `.yaml` `.yml` `.log` `.ini` `.cfg` `.conf` `.toml` `.srt` `.vtt` `.vcf` `.ics` `.css` `.js` `.csv` `.tsv`	The text sheet (Markdown's front matter as a table; a calendar's and an address book's cards); a table for CSV and TSV; a script is read, never run
Web and mail	`.html` `.htm` `.eml` `.msg`	A web page as a browser draws it, its own styles and pictures from its folder; a letter with its attachments
3D	`.glb` `.gltf` `.stl` `.obj` `.ply` `.3mf` `.gcode`	Orbit, pan, zoom; a scan's points; a print package; G-code sliced a layer at a time
GPS	`.gpx` `.kml` `.kmz` `.geojson`	The route on a grid with a dot, linked by the clock to a video or a photo; a picture pinned under it
Canvas	`.canvas`	An Obsidian canvas: its cards and arrows, panned and zoomed

By name or content

.nii.gz — a NIfTI volume kept compressed, as research tools keep them.
A patient CD — DICOMDIR (the disc's index) and DICOM files with no extension at all, known by their content.
An Internet Archive _jp2.zip — a book's JPEG 2000 pages.
A .json that is an srScout tour (tour.json), a Scrollr story (story.json), a three.js scene or a vxKite panel (0.99.02: knobs, sliders, levers, switches, buttons, joysticks, pads, gear trains and flywheels that drive the file beside it) — each in its own view.
A website's folder — its index.html with the stylesheets, pictures and fonts beside it.

On a card (0.99.5)

A hotspot's Card, and a media map item's, shows its file small over the page or the map, Live showing it too: a picture (a camera RAW by its own picture of it; a 360 photo on its sphere, to drag round); a video (a 360 clip on its sphere) or a sound with its own player (a sound with its cover and tags); a three.js scene, playing, or a model to turn (.glb .gltf .stl .obj .ply .3mf); a web page as its pane draws it, its links, forms and scripts off; text, data or a script as text, read and never run (the first 2 MB; a file past 64 MB opens beside); a PDF's page. Everything else opens beside, where its own tools are: a GPS track, a panel, a book, a comic, an Office file, mail, a studio file, medical files, G-code, a brain's surface, an Obsidian canvas, a tour or a story.

Not opened, on purpose

DjVu (every renderer is GPL; a PDF of the same pages opens), USD and FBX, CAD files, a .hdr/.img pair, MKV and AVCHD (.mts) video — each says so in a sentence. MPEG-1, WMV and AVI video are not opened either: convert them to MP4 (H.264) first.

Removing vxKite

Uninstalling takes the program away; what vxKite wrote stays where it was written, because some of it is yours. Your job folders are yours: what vxKite wrote in a job — its vxKite/ folder, marked-list.md and marked-list.json — belongs to that case and travels with it. Removing vxKite never touches a job folder; keep or delete each job as you would any case file. To leave nothing else behind: - Mac: 1. Quit vxKite (⌘Q) and drag vxKite from Applications to the Trash. 2. In Finder choose Go → Go to Folder… (⇧⌘G), paste each line below, press Return, and drag what it shows to the Trash: - ~/Library/Caches/com.vxkite.desktop (the cache) - ~/Library/Logs/com.vxkite.desktop (the log — it names the files you opened) - ~/Library/WebKit/com.vxkite.desktop (recent job folders and where each was left, the accent colour, the bars each window hides, your choices) - ~/Library/Preferences/com.vxkite.desktop.plist (the Mac's memory of the last folder you opened in vxKite's Open dialog) 3. If you don't need them, drag ~/Documents/vxKite to the Trash too: your saved signature, your favourite labels, what you made with no job open, and log copies. 4. In System Settings → Privacy & Security, under Camera and under Screen & System Audio Recording, switch vxKite off if it is listed (or select it and click − where there is one). 5. Empty the Trash when you are sure. - Windows: close vxKite; Start → Settings → Apps → Installed apps → vxKite → ⋯ → Uninstall, and in vxKite's uninstaller tick Delete the application data to remove %LOCALAPPDATA%\com.vxkite.desktop (the cache, the log, the settings, the web view's data). If you did not tick it, or your vxKite was 0.98.90 or older (an MSI, whose uninstaller does not ask), delete that folder by hand: Windows + R, %LOCALAPPDATA%, Enter. Documents\vxKite stays either way unless you delete it. Leave Microsoft Edge WebView2 Runtime alone: it is part of Windows and other programs use it.

When something goes wrong

Type / .log. vxKite copies its diagnostic log to Documents/vxKite/ as that day's .txt (one a day) and shows it on the operator's window, in the reader About's licences use (never in a pane, never on Live) — that is the file to send. It holds every status line the app showed and the files it opened, with their paths — never a file's contents. The words you type to search — in Find, in the command bar, for a segment — are kept out of it, (the words typed) standing in their place (0.99.0), as are a guided stop's note and a branch's name. The log itself is vxkite.log (and one .prev) in ~/Library/Logs/com.vxkite.desktop/ on a Mac, %LOCALAPPDATA%\com.vxkite.desktop\logs\ on Windows, about 2 MB at most. To delete it, quit vxKite and delete that folder, and any vxKite log <date>.txt copies in Documents/vxKite/.