Skip to content

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.md
new file mode 100644
index 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.tsx
index 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, SettingsSegm
import { 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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: "渲染播放卡顿的片段",