The open source AI video agent: turns any coding agent into a video agent, with an editor to change anything it makes.
Settings: Advanced, under Help, for what is set for the best experience (#122)
riverisbuildingef79883ff703
diff --git a/.changeset/settings-advanced.md b/.changeset/settings-advanced.mdnew file mode 100644index 0000000..67bbc9b--- /dev/null+++ b/.changeset/settings-advanced.md@@ -0,0 +1,5 @@+---+"openfilm": patch+---++Settings: "Draw pages at the viewer's size" and "Render what plays late" move from General to a new Advanced section under Help. Both stay on, as they were.diff --git a/packages/openfilm/studio/ui/src/components/settings/SettingsModal.tsx b/packages/openfilm/studio/ui/src/components/settings/SettingsModal.tsxindex 5d1fa4d..f7a3f0b 100644--- a/packages/openfilm/studio/ui/src/components/settings/SettingsModal.tsx+++ b/packages/openfilm/studio/ui/src/components/settings/SettingsModal.tsx@@ -2,12 +2,12 @@* Settings, opened from the logo at the top left: a search and the sections in groups on the left, the section on the* right as a page of titled groups. General (the theme and the language), Agents (in an app with a chat: the agents* it can use), Providers (the person's own keys for media services), Models (which provider and model makes each kind- * of media), the keyboard shortcuts and Developer; the search finds a section by any phrase on it. At the foot of the- * nav, quietly, where OpenFilm lives: its code, the examples and the website.+ * of media), the keyboard shortcuts, Advanced and Developer; the search finds a section by any phrase on it. At the+ * foot of the nav, quietly, where OpenFilm lives: its code, the examples and the website.*/import React from 'react';import { createPortal } from 'react-dom';-import { X, Settings2, Keyboard, Sun, Moon, Monitor, Plug, Boxes, Bot, Search, SquareTerminal, Loader2 } from 'lucide-react';+import { X, Settings2, Keyboard, Sun, Moon, Monitor, Plug, Boxes, Bot, Search, SquareTerminal, Loader2, SlidersHorizontal } from 'lucide-react';import { LANGUAGES, phrasesUnder, useLanguage, useLanguageChoice, useT, type LanguageChoice } from '@/i18n';import { shortcutHint } from '@/lib/shortcut-hint';import { SHORTCUTS, type ShortcutKey } from '@/lib/timeline-keys';@@ -26,13 +26,13 @@ import { SettingsButton, SettingsGroup, SettingsItem, SettingsPage, SettingsSegmimport { useThemeMode, type ThemeMode } from './theme';import { StorageGroup } from './StorageGroup';-export type SettingsSection = 'general' | 'agents' | 'providers' | 'models' | 'developer' | 'shortcuts';+export type SettingsSection = 'general' | 'agents' | 'providers' | 'models' | 'developer' | 'shortcuts' | 'advanced';/* the nav, in groups: what OpenFilm does, then help (Agents only inside an app with a chat: lib/host.ts `agents`;- Developer always, for its diagnostics) */+ Advanced for what is already set for the best experience; Developer always, for its diagnostics) */const NAV: Array<{ group: 'settings' | 'help'; sections: SettingsSection[] }> = [{ group: 'settings', sections: ['general', ...(studioHost?.agents ? ['agents' as const] : []), 'providers', 'models'] },- { group: 'help', sections: ['shortcuts', 'developer'] },+ { group: 'help', sections: ['shortcuts', 'advanced', 'developer'] },];/** where OpenFilm lives, linked at the foot of the nav */@@ -49,6 +49,7 @@ const SECTION_ICON: Record<SettingsSection, React.ReactNode> = {models: <Boxes size={18} strokeWidth={1.75} />,developer: <SquareTerminal size={18} strokeWidth={1.75} />,shortcuts: <Keyboard size={18} strokeWidth={1.75} />,+ advanced: <SlidersHorizontal size={18} strokeWidth={1.75} />,};/** what a search through each section reads: its name and every phrase it shows */@@ -59,6 +60,7 @@ const SECTION_WORDS: Record<SettingsSection, string | string[]> = {models: 'settings.models',developer: ['settings.developer', 'settings.report'],shortcuts: 'settings.shortcuts',+ advanced: 'settings.advanced',};export interface SettingsModalProps {@@ -192,6 +194,7 @@ export function SettingsModal({ open, onClose, section: opening }: SettingsModal{showing === 'models' && <ModelsSection onConnect={() => { setQuery(''); setSection('providers'); }} />}{showing === 'developer' && <DeveloperSection />}{showing === 'shortcuts' && <ShortcutsSection />}+ {showing === 'advanced' && <AdvancedSection />}</div></div></div>@@ -250,12 +253,11 @@ function GeneralSection() {/*** How the preview plays heavy footage (studio/server/proxies.mjs): from a lighter copy made in the background (a- * proxy), and how tall that copy is; whether pages draw at the viewer's size, and whether stretches that play- * late are rendered to play smoothly (lib/preview-prefs). Exports always read the originals and draw at full size.+ * proxy), and how tall that copy is (Advanced has how pages draw and what plays late). Exports always read the+ * originals and draw at full size.*/function PlaybackGroup() {const t = useT();- const { fitPages, renders } = usePreviewPrefs();const [prefs, setPrefs] = React.useState<StudioPrefs | null>(null);React.useEffect(() => { void api.prefs().then(setPrefs).catch(() => {}); }, []);if (!prefs) return null;@@ -284,20 +286,35 @@ function PlaybackGroup() {)}/>) : null}- <SettingsItem- title={t('settings.playback.fitPages')}- description={t('settings.playback.fitPagesHint')}- control={<SettingsSwitch checked={fitPages} onChange={(on) => writePreviewPref('fitPages', on)} label={t('settings.playback.fitPages')} />}- />- <SettingsItem- title={t('settings.playback.renders')}- description={t('settings.playback.rendersHint')}- control={<SettingsSwitch checked={renders} onChange={(on) => writePreviewPref('renders', on)} label={t('settings.playback.renders')} />}- /></SettingsGroup>);}+/**+ * What is already set for the best experience, for whoever wants it otherwise: whether pages draw at the viewer's+ * size, and whether stretches that play late are rendered to play smoothly (lib/preview-prefs). Both on by default.+ */+function AdvancedSection() {+ const t = useT();+ const { fitPages, renders } = usePreviewPrefs();+ return (+ <SettingsPage note={t('settings.advanced.intro')}>+ <SettingsGroup title={t('settings.playback.group')}>+ <SettingsItem+ title={t('settings.advanced.fitPages')}+ description={t('settings.advanced.fitPagesHint')}+ control={<SettingsSwitch checked={fitPages} onChange={(on) => writePreviewPref('fitPages', on)} label={t('settings.advanced.fitPages')} />}+ />+ <SettingsItem+ title={t('settings.advanced.renders')}+ description={t('settings.advanced.rendersHint')}+ control={<SettingsSwitch checked={renders} onChange={(on) => writePreviewPref('renders', on)} label={t('settings.advanced.renders')} />}+ />+ </SettingsGroup>+ </SettingsPage>+ );+}+/*** This Studio's version and whether npm has a newer openfilm. In the desktop app, Studio comes with the app and is* updated with it; anywhere else the person (or their agent) runs the latest, and the CLI restarts Studio on it.diff --git a/packages/openfilm/studio/ui/src/i18n/en.ts b/packages/openfilm/studio/ui/src/i18n/en.tsindex a5ad9f8..565454a 100644--- a/packages/openfilm/studio/ui/src/i18n/en.ts+++ b/packages/openfilm/studio/ui/src/i18n/en.ts@@ -1457,6 +1457,7 @@ export const en = {developer: 'Developer',general: 'General',shortcuts: 'Keyboard shortcuts',+ advanced: 'Advanced',},appearance: {group: 'Appearance',@@ -1493,6 +1494,9 @@ export const en = {proxiesHint: "Footage past 1080p, or slow to decode (ProRes, HEVC, 10-bit), plays from a lighter copy made in the background. Exports always use the originals.",proxySize: "Proxy size",proxySizeHint: "Smaller plays more smoothly; larger looks sharper in the viewer.",+ },+ advanced: {+ intro: "These are set for the best experience. You don’t need to change them.",fitPages: "Draw pages at the viewer’s size",fitPagesHint: "Canvas and 3D in web pages are drawn at the size the viewer shows them, which plays more smoothly and looks the same. Off: at the film’s full size. Exports always draw at full size.",renders: "Render what plays late",diff --git a/packages/openfilm/studio/ui/src/i18n/es.ts b/packages/openfilm/studio/ui/src/i18n/es.tsindex d8420ba..2b602ee 100644--- a/packages/openfilm/studio/ui/src/i18n/es.ts+++ b/packages/openfilm/studio/ui/src/i18n/es.ts@@ -1456,6 +1456,7 @@ export const es: Words = {developer: 'Desarrollador',general: 'General',shortcuts: 'Atajos de teclado',+ advanced: 'Avanzado',},appearance: {group: 'Apariencia',@@ -1492,6 +1493,9 @@ export const es: Words = {proxiesHint: "El metraje de más de 1080p, o lento de decodificar (ProRes, HEVC, 10 bits), se reproduce desde una copia ligera hecha en segundo plano. Las exportaciones siempre usan los originales.",proxySize: "Tamaño del proxy",proxySizeHint: "Más pequeño se reproduce con más fluidez; más grande se ve más nítido en el visor.",+ },+ advanced: {+ intro: "Ya están ajustados para la mejor experiencia. Normalmente no hace falta cambiarlos.",fitPages: "Dibujar las páginas al tamaño del visor",fitPagesHint: "El canvas y el 3D de las páginas web se dibujan al tamaño con que los muestra el visor: se ven igual y se reproducen con más fluidez. Desactivado: al tamaño completo de la película. Las exportaciones siempre se dibujan a tamaño completo.",renders: "Renderizar lo que se reproduce con retraso",diff --git a/packages/openfilm/studio/ui/src/i18n/ja.ts b/packages/openfilm/studio/ui/src/i18n/ja.tsindex 752b669..0735cc1 100644--- a/packages/openfilm/studio/ui/src/i18n/ja.ts+++ b/packages/openfilm/studio/ui/src/i18n/ja.ts@@ -1456,6 +1456,7 @@ export const ja: Words = {developer: '開発者',general: '一般',shortcuts: 'キーボードショートカット',+ advanced: '詳細設定',},appearance: {group: '外観',@@ -1492,6 +1493,9 @@ export const ja: Words = {proxiesHint: "1080p を超える素材や、デコードが重い素材(ProRes、HEVC、10 ビット)は、バックグラウンドで作る軽いコピーで再生します。書き出しには常に元の素材を使います。",proxySize: "プロキシのサイズ",proxySizeHint: "小さいほど滑らかに再生でき、大きいほどビューアで鮮明に見えます。",+ },+ advanced: {+ intro: "最適な設定になっています。通常は変更する必要はありません。",fitPages: "Web ページをビューアのサイズで描画",fitPagesHint: "Web ページの Canvas と 3D を、ビューアに表示されるサイズで描画します。見た目は同じで、より滑らかに再生できます。オフにすると作品のフルサイズで描画します。書き出しは常にフルサイズです。",renders: "遅れる区間をレンダリング",diff --git a/packages/openfilm/studio/ui/src/i18n/ko.ts b/packages/openfilm/studio/ui/src/i18n/ko.tsindex 30fa962..c490946 100644--- a/packages/openfilm/studio/ui/src/i18n/ko.ts+++ b/packages/openfilm/studio/ui/src/i18n/ko.ts@@ -1455,6 +1455,7 @@ export const ko: Words = {developer: '개발자',general: '일반',shortcuts: '키보드 단축키',+ advanced: '고급',},appearance: {group: '모양',@@ -1491,6 +1492,9 @@ export const ko: Words = {proxiesHint: "1080p를 넘거나 디코딩이 무거운(ProRes, HEVC, 10비트) 영상은 백그라운드에서 만든 가벼운 사본으로 재생합니다. 내보내기에는 항상 원본을 씁니다.",proxySize: "프록시 크기",proxySizeHint: "작을수록 더 부드럽게 재생되고, 클수록 뷰어에서 더 선명합니다.",+ },+ advanced: {+ intro: "최적의 환경으로 설정되어 있어 보통은 바꿀 필요가 없습니다.",fitPages: "웹 페이지를 뷰어 크기로 그리기",fitPagesHint: "웹 페이지의 Canvas와 3D를 뷰어에 보이는 크기로 그립니다. 보기에는 같고 더 부드럽게 재생됩니다. 끄면 영상의 전체 크기로 그립니다. 내보내기는 항상 전체 크기입니다.",renders: "느리게 재생되는 구간 렌더링",diff --git a/packages/openfilm/studio/ui/src/i18n/zh-CN.ts b/packages/openfilm/studio/ui/src/i18n/zh-CN.tsindex 05f11bf..b2f9754 100644--- a/packages/openfilm/studio/ui/src/i18n/zh-CN.ts+++ b/packages/openfilm/studio/ui/src/i18n/zh-CN.ts@@ -1457,6 +1457,7 @@ export const zhCN: Words = {developer: '开发者',general: '通用',shortcuts: '键盘快捷键',+ advanced: '高级',},appearance: {group: '外观',@@ -1493,6 +1494,9 @@ export const zhCN: Words = {proxiesHint: "超过 1080p 或解码较慢(ProRes、HEVC、10 位)的素材,会在后台生成一份轻量副本用于预览播放。导出始终使用原素材。",proxySize: "代理分辨率",proxySizeHint: "越小播放越流畅,越大预览越清晰。",+ },+ advanced: {+ intro: "这些已设为最佳体验,一般不用改。",fitPages: "按查看器尺寸绘制网页",fitPagesHint: "网页里的 Canvas 和 3D 按查看器实际显示的尺寸绘制,看起来一样,播放更流畅。关闭后按影片完整尺寸绘制。导出始终按完整尺寸。",renders: "渲染播放卡顿的片段",