Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
50f78c9
Export a self-contained HTML deck
razodin137 Nov 17, 2026
9aeab89
Package the fork as hype-html
razodin137 Nov 17, 2026
1839c1d
Export an editable HTML deck folder
razodin137 Nov 17, 2026
3c4c2da
Omit file chooser filters when there are no patterns
razodin137 Nov 17, 2026
99c78f4
thanks:
razodin137 Nov 17, 2026
0b4f211
pkgbuild: derive source from the checkout; drop build artifacts
razodin137 Nov 18, 2026
4b91aff
thanks
razodin137 Nov 18, 2026
84809a6
markdown editable HTML
razodin137 Nov 18, 2026
5e5edb3
Name exported copies in the editable HTML deck
razodin137 Nov 18, 2026
1522a05
Add the shader transition registry
razodin137 Nov 18, 2026
a9c15fe
Model transitions as deck defaults and slide directives
razodin137 Nov 18, 2026
862503c
added GLSL shader transitions to the exports and the hype app
razodin137 Nov 18, 2026
4408329
Register the browser transition tests in the unittest suite
razodin137 Nov 18, 2026
3001775
prompt series
razodin137 Nov 18, 2026
1d14196
Read slide properties outside code
razodin137 Nov 18, 2026
1216084
Strip speaker notes within each slide
razodin137 Nov 18, 2026
aa3d4b8
Escape attribute values in themed SVG drawings
razodin137 Nov 18, 2026
a257573
Keep backslashes inside inline code spans
razodin137 Nov 18, 2026
c0c4a34
Repaint slide textures for moving media at transition start
razodin137 Nov 18, 2026
483b550
split: 05-refresh-video-textures
razodin137 Nov 18, 2026
c705309
Bound the exported deck's slide texture cache
razodin137 Nov 18, 2026
ae4536b
Wait for slide media before animating a transition
razodin137 Nov 18, 2026
e167f31
Hold the outgoing slide while a transition prepares
razodin137 Nov 18, 2026
a35facd
Register the browser render tests in the unittest suite
razodin137 Nov 18, 2026
7f7a251
Ignore scratch logs and app backups
razodin137 Nov 18, 2026
d764623
fixes
razodin137 Nov 18, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,4 +1,7 @@
/build/
/trials/
/prompt/
/.scratch/
**/.hype-backups/
*.user
__pycache__/
42 changes: 39 additions & 3 deletions CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,8 @@ endif()

find_package(Qt6 6.9 REQUIRED COMPONENTS
Core Gui Qml Quick QuickControls2 Multimedia Concurrent DBus Svg Widgets Test)
# qsb is a build-time tool: Qt Quick loads only baked shader packages.
find_package(Qt6 6.9 REQUIRED COMPONENTS ShaderToolsTools)
find_package(PkgConfig REQUIRED)
pkg_check_modules(WEBP REQUIRED IMPORTED_TARGET libwebp libwebpdemux)
find_package(ZLIB REQUIRED)
Expand Down Expand Up @@ -54,7 +56,37 @@ else()
endif()
endif()

# Slide transitions are one ES 1.00 body each, shared with the HTML exports. Qt
# Quick's ShaderEffect only loads baked shader packages in Qt 6, so every body is
# wrapped in modern GLSL and compiled by qsb here, then embedded as
# :/transitions/<name>.frag.qsb for the QML to load. A new .glsl file is enough:
# the glob picks it up, as the registry picks up its name.
file(GLOB transition_bodies CONFIGURE_DEPENDS src/transitions/*.glsl)
list(REMOVE_ITEM transition_bodies "${CMAKE_SOURCE_DIR}/src/transitions/common.glsl")
set(transition_shaders "")
foreach(body IN LISTS transition_bodies)
get_filename_component(transition_name "${body}" NAME_WE)
set(transition_frag "${CMAKE_CURRENT_BINARY_DIR}/transitions/${transition_name}.frag")
set(transition_qsb "${transition_frag}.qsb")
add_custom_command(OUTPUT "${transition_frag}"
COMMAND ${CMAKE_COMMAND}
"-DCOMMON=${CMAKE_SOURCE_DIR}/src/transitions/common.glsl"
"-DBODY=${body}"
"-DOUTPUT=${transition_frag}"
-P "${CMAKE_SOURCE_DIR}/cmake/wrap-transition.cmake"
DEPENDS "${body}" "${CMAKE_SOURCE_DIR}/src/transitions/common.glsl"
"${CMAKE_SOURCE_DIR}/cmake/wrap-transition.cmake"
VERBATIM)
add_custom_command(OUTPUT "${transition_qsb}"
COMMAND $<TARGET_FILE:Qt6::qsb> --qt6 -o "${transition_qsb}" "${transition_frag}"
DEPENDS "${transition_frag}"
VERBATIM)
list(APPEND transition_shaders "${transition_qsb}")
endforeach()

add_executable(hype src/main.cpp src/resources.qrc)
qt_add_resources(hype "transition_shaders" PREFIX "/transitions"
BASE "${CMAKE_CURRENT_BINARY_DIR}/transitions" FILES ${transition_shaders})
target_link_libraries(hype PRIVATE hype_core)
target_compile_definitions(hype PRIVATE HYPE_VERSION="${HYPE_VERSION}")
set_target_properties(hype PROPERTIES INTERPROCEDURAL_OPTIMIZATION ON)
Expand All @@ -67,6 +99,8 @@ find_package(Qt6 6.9 COMPONENTS Pdf)
if(TARGET Qt6::Pdf)
# The window-level tests load the same QML as the app, so they embed it too.
add_executable(hype_tests tests/tests.cpp src/resources.qrc)
qt_add_resources(hype_tests "transition_shaders" PREFIX "/transitions"
BASE "${CMAKE_CURRENT_BINARY_DIR}/transitions" FILES ${transition_shaders})
target_link_libraries(hype_tests PRIVATE hype_core Qt6::Widgets Qt6::Pdf Qt6::Test)
set_target_properties(hype_tests PROPERTIES INTERPROCEDURAL_OPTIMIZATION ON)
add_test(NAME hype_tests COMMAND hype_tests)
Expand All @@ -78,12 +112,14 @@ endif()
set_tests_properties(hype_tests PROPERTIES ENVIRONMENT
"QT_QPA_PLATFORM=offscreen;QT_QPA_PLATFORMTHEME=generic;QT_STYLE_OVERRIDE=Fusion")

# The commands, exports and shutdown, driven through build/hype as an agent would.
# test_trials covers the trial import tools, which need their own Python packages.
# The commands, exports and shutdown through build/hype as an agent would, and
# the exported deck's navigation and rendering in a browser (skipped where
# chromium is absent). test_trials covers the trial import tools, which need
# their own Python packages.
find_package(Python3 COMPONENTS Interpreter)
if(Python3_FOUND)
add_test(NAME hype_commands
COMMAND ${Python3_EXECUTABLE} -m unittest test_cli test_export test_shutdown
COMMAND ${Python3_EXECUTABLE} -m unittest test_cli test_export test_deck_navigation test_deck_render test_deck_svg test_deck_transitions test_shutdown
WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}/tests)
else()
add_test(NAME hype_commands COMMAND sh -c "echo 'hype_commands needs Python 3' >&2; exit 1")
Expand Down
15 changes: 10 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Simple presentations, written in Markdown. Big headlines, images, video, and code—with a visual editor to put everything in order.

Hype is a native app for Omarchy. Your presentation is a Markdown file with its media alongside it. Choose an installed Omarchy theme, pick a font, and export to PDF or PowerPoint.
Hype is a native app for Omarchy. Your presentation is a Markdown file with its media alongside it. Choose an installed Omarchy theme, pick a font, and export to PDF, PowerPoint, or a self-contained HTML deck.

## Install

Expand Down Expand Up @@ -167,7 +167,11 @@ Click **Present** or press **Ctrl+Space** (or **F5**) to toggle fullscreen prese

Finished videos hold their last frame. Press Space again to replay from the beginning.

Choose **Export as PDF** or **Export as PowerPoint** from the file menu in the top bar, or press **Ctrl+E** for PDF and **Ctrl+Shift+E** for PowerPoint, to share your presentation. Both exports are built into Hype. PowerPoint renders slides and converted animations at 4K (3840 × 2160), storing slides as high-quality JPEG like the pictures in a PDF. Slides preserve the rendered appearance rather than exposing editable text and shapes; the receiving computer does not need your fonts installed. Videos are embedded, and animated WebP/GIF images are converted to MP4 automatically without changing the original files. PDF captures still slides.
Choose **Export as PDF**, **Export as PowerPoint**, **Export as HTML**, or **Export as HTML folder** from the file menu in the top bar, or press **Ctrl+E** for PDF, **Ctrl+Shift+E** for PowerPoint, **Ctrl+Alt+E** for HTML, and **Ctrl+Alt+Shift+E** for an HTML folder, to share your presentation. All exports are built into Hype. PowerPoint renders slides and converted animations at 4K (3840 × 2160), storing slides as high-quality JPEG like the pictures in a PDF. Slides preserve the rendered appearance rather than exposing editable text and shapes; the receiving computer does not need your fonts installed. Videos are embedded, and animated WebP/GIF images are converted to MP4 automatically without changing the original files. PDF captures still slides.

**Export as HTML** writes one self-contained file: every slide rendered at 1920 pixels wide, inlined as WebP, wrapped in a page with arrow-key, click, swipe, and touch navigation, a slide counter, and `#N` deep links. It opens in any browser straight from a file manager or an email attachment — no fonts, no internet, no unzipping. The deck's Markdown rides inside the page as an inert block, so the file also carries its editable source wherever it goes. The Markdown file stays the source of truth; export again to refresh the deck.

**Export as HTML folder** writes the same deck as an editable folder: the Markdown rides inside `index.html`, which renders it with `deck.js` and `deck.css` — mirroring Hype's layout, theme, and media directives — beside the deck's real images and videos. Edit the Markdown block in any text editor, refresh the browser, and the deck updates; no Hype needed. Pick a new or empty folder; export again to refresh it. Zip the folder to share the whole deck.

Export runs in the background. The top bar shows progress through rendering, video conversion, and packaging under the presentation name, with a **Cancel export** button. You can keep editing; the export uses the presentation as it was when you started. Failed or cancelled exports leave an existing file intact.

Expand All @@ -185,7 +189,8 @@ hype check talk/presentation.md # every problem, with its slid
hype slides talk/presentation.md # an outline: number, lines, headline, media
hype render talk/presentation.md --slide 3 -o slide.png
hype render talk/presentation.md -o slides/ # every slide, plus slides.json
hype export talk/presentation.md talk.pdf # or talk.pptx
hype export talk/presentation.md talk.pdf # or talk.pptx, or talk.html for a web deck
hype export talk/presentation.md site/ # or a folder in /: an editable HTML deck
hype themes
```

Expand All @@ -206,7 +211,7 @@ Slide navigation and selection shortcuts apply when the sidebar or preview has f
| Ctrl+N / Ctrl+O | New presentation / open file |
| Ctrl+S / Ctrl+Shift+S | Save / save as |
| Ctrl+Q | Quit |
| Ctrl+E / Ctrl+Shift+E | Export as PDF / PowerPoint |
| Ctrl+E / Ctrl+Shift+E / Ctrl+Alt+E / Ctrl+Alt+Shift+E | Export as PDF / PowerPoint / HTML deck / HTML folder |
| Ctrl+M | Overview on / off |
| Ctrl+. | Markdown source on / off |
| Ctrl+B / Ctrl+I / Ctrl+U | Bold / italic / underline |
Expand Down Expand Up @@ -245,7 +250,7 @@ The mouse wheel over the sidebar selects the previous or next slide. Home/End ju

## Run from source

To build Hype yourself, install a C++17 compiler, CMake, Qt 6.9 or newer, FFmpeg, and GNU source-highlight; see [the package definition in omarchy-pkgs](https://github.com/omacom/omarchy-pkgs/blob/master/pkgbuilds/hype/PKGBUILD) for dependencies. Then:
To build Hype yourself, install a C++17 compiler, CMake, Qt 6.9 or newer (including Qt Shader Tools, which provides `qsb`), FFmpeg, and GNU source-highlight; see [the package definition in omarchy-pkgs](https://github.com/omacom/omarchy-pkgs/blob/master/pkgbuilds/hype/PKGBUILD) for dependencies. Then:

```sh
./bin/build
Expand Down
37 changes: 37 additions & 0 deletions cmake/wrap-transition.cmake
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
# Composes one transition into the modern GLSL that qsb bakes for Qt Quick's
# ShaderEffect. The ES 1.00 body stays the single source both renderers compile;
# only the wrapper differs from the HTML exports' WebGL one.
#
# cmake -DCOMMON=<common.glsl> -DBODY=<name>.glsl -DOUTPUT=<name>.frag -P ...
#
# Qt Quick supplies the vertex shader, whose output is qt_TexCoord0. ShaderEffect
# packs the effect's properties into a std140 block bound at 0, while samplers
# keep their own binding points, so fromTex and toTex match the QML properties of
# those names and progress matches the QML progress property.

foreach(input COMMON BODY)
if(NOT EXISTS "${${input}}")
message(FATAL_ERROR "wrap-transition: ${input} not found: ${${input}}")
endif()
endforeach()

file(READ "${COMMON}" common)
file(READ "${BODY}" body)

set(wrapper [=[#version 440
layout(location = 0) in vec2 qt_TexCoord0;
layout(location = 0) out vec4 fragColor;
layout(std140, binding = 0) uniform buf {
mat4 qt_Matrix;
float qt_Opacity;
float progress;
};
layout(binding = 1) uniform sampler2D fromTex;
layout(binding = 2) uniform sampler2D toTex;
#define varying in
#define texture2D texture
#define gl_FragColor fragColor
]=])

file(WRITE "${OUTPUT}"
"${wrapper}\n${common}\n${body}\n\nvoid main() { gl_FragColor = transition(qt_TexCoord0); }\n")
30 changes: 15 additions & 15 deletions examples/welcome.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,21 +4,6 @@ font: JetBrains Mono
theme: tokyo-night
---

# Your next idea

Markdown in. A presentation out.

---

# Keep it simple

- Write in Markdown
- Drag slides to reorder
- Duplicate the good ones
- Pick an Omarchy theme

---

> A presentation is a sequence of ideas.
> Give each one room to breathe.

Expand All @@ -33,6 +18,15 @@ Sovereign

---

# Keep it simple

- Write in Markdown
- Drag slides to reorder
- Duplicate the good ones
- Pick an Omarchy theme

---

# The source is the document

```ruby
Expand All @@ -45,6 +39,12 @@ end

---

# Your next idea

Markdown in. A presentation out.

---

# One folder

| Directory | Contents |
Expand Down
8 changes: 8 additions & 0 deletions pkgbuild/hype-html.desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
[Desktop Entry]
Type=Application
Name=Hype HTML
Comment=Markdown presentations, exported as self-contained HTML decks
Exec=hype-html open %f
Icon=hype-html
Terminal=false
Categories=Office;Presentation;
6 changes: 6 additions & 0 deletions pkgbuild/hype-html/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# makepkg artifacts: the SRCDEST git mirror (named after pkgname), the build
# tree, the staging root, and built packages.
/hype-html/
/src/
/pkg/
/*.pkg.tar.zst
49 changes: 49 additions & 0 deletions pkgbuild/hype-html/PKGBUILD
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
# Package this fork as hype-html, beside an installed hype: the same app with
# the HTML deck export, under its own name, icon, and desktop entry. The
# source is the checkout this PKGBUILD lives in, at the branch checked out
# there, so commit before building and re-run makepkg after pulling.
pkgname=hype-html
pkgver=0.7.1
pkgrel=1
pkgdesc='Simple Markdown presentations with a visual slide editor and self-contained HTML deck export'
arch=('x86_64')
url='https://github.com/razodin137/hype'
license=('MIT')
options=('!debug')
depends=(
'ffmpeg'
'hicolor-icon-theme'
'qt6-base>=6.9'
'qt6-declarative>=6.9'
'qt6-multimedia>=6.9'
'qt6-imageformats'
'qt6-svg'
'source-highlight'
'zlib'
'libwebp'
'xdg-desktop-portal'
'qt6-wayland'
)
makedepends=('cmake' 'gcc' 'make' 'pkgconf' 'git' 'qt6-shadertools')

# This PKGBUILD sits at <checkout>/pkgbuild/hype-html, so the checkout root is
# two levels up. Cloning from there lets any checkout build itself; git source
# means the package still tracks the committed branch, not the working tree.
_checkout="$(realpath -- "$(dirname -- "${BASH_SOURCE[0]}")/../..")"
source=("$pkgname::git+file://${_checkout}")
sha256sums=('SKIP')

build() {
cd "$srcdir/$pkgname"
./bin/build
}

package() {
cd "$srcdir/$pkgname"

install -Dm755 build/hype "$pkgdir/usr/bin/hype-html"
install -Dm644 LICENSE "$pkgdir/usr/share/licenses/$pkgname/LICENSE"
install -Dm644 pkgbuild/hype.svg "$pkgdir/usr/share/icons/hicolor/scalable/apps/hype-html.svg"
install -Dm644 pkgbuild/hype-html.desktop "$pkgdir/usr/share/applications/hype-html.desktop"
install -Dm644 README.md "$pkgdir/usr/share/doc/$pkgname/README.md"
}
105 changes: 105 additions & 0 deletions scripts/split-serial.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,105 @@
#!/usr/bin/env bash
# Replay a prompt pack: one prompt per fresh session, stopping at the first
# failing gate. Run it in the repo the prompts change.
#
# ./scripts/split-serial.sh pack is ./prompt
# ./scripts/split-serial.sh ../packs/listmonk
# CHECK_ONLY=1 ./scripts/split-serial.sh print pack and gate, run nothing
# CHECK='make test' ./scripts/split-serial.sh
# COMMIT=0 ./scripts/split-serial.sh leave commits alone
# FROM=05-name ./scripts/split-serial.sh resume at a step
#
# Files run in filename order, so 01-, 02-, 03- sets the order. Logs land in
# .scratch/split/ and are never staged for commit.

set -euo pipefail

usage() {
awk 'NR > 1 { if ($0 !~ /^#/) exit; sub(/^# ?/, ""); print }' "$0"
}

if [ "${1:-}" = "-h" ] || [ "${1:-}" = "--help" ]; then
usage
exit 0
fi

if ! [ -d prompt ] && [ "$(basename "$PWD")" = "scripts" ] && [ -d ../prompt ]; then
cd ..
fi

PACK=${1:-${PACK:-prompt}}
MODEL=${MODEL:-ollama/deepseek-v4.1-flash:1017-cloud}
COMMIT=${COMMIT:-1}
FROM=${FROM:-}
LOGS=.scratch/split

if [ ! -d "$PACK" ]; then
echo "no pack at $PACK; prompts live in <repo>/$PACK" >&2
exit 1
fi

shopt -s nullglob
files=("$PACK"/*.md)
shopt -u nullglob

if [ ${#files[@]} -eq 0 ]; then
echo "no prompts in $PACK" >&2
exit 1
fi

CHECK=${CHECK:-}
if [ -z "$CHECK" ] && [ -f package.json ] && \
node -e 'process.exit(require("./package.json").scripts?.check ? 0 : 1)' 2>/dev/null; then
CHECK="npm run check"
fi

if [ "${CHECK_ONLY:-0}" = "1" ]; then
printf 'repo: %s\n' "$PWD"
printf 'pack: %s (%d prompts)\n' "$PACK" "${#files[@]}"
printf 'check: %s\n' "${CHECK:-none}"
exit 0
fi

if ! git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
COMMIT=0
fi

if [ "$COMMIT" = "1" ] && [ -n "$(git status --porcelain --untracked-files=normal -- . ':(exclude).scratch')" ]; then
echo "tree is dirty; commit it first, or run with COMMIT=0" >&2
exit 1
fi

mkdir -p "$LOGS"

for file in "${files[@]}"; do
name=$(basename "$file" .md)
if [ -n "$FROM" ] && [[ "$name" < "$FROM" ]]; then
continue
fi

echo "== $name"
if ! opencode run -m "$MODEL" --auto --title "split $name" "$(cat "$file")" 2>&1 \
| tee "$LOGS/$name.log"; then
echo "== $name: opencode failed, stopping" >&2
exit 1
fi

if [ -n "$CHECK" ]; then
if ! eval "$CHECK" >"$LOGS/$name.check" 2>&1; then
echo "== $name: check failed: $CHECK" >&2
echo "== see $LOGS/$name.check; fix, then resume with FROM=$name" >&2
exit 1
fi
fi

if [ "$COMMIT" = "1" ]; then
git add -A -- . ':(exclude).scratch'
if git diff --cached --quiet; then
echo "== $name: nothing to commit"
else
git commit -q -m "split: $name"
fi
fi
done

echo "== finished"
Loading