Project tiers
Keep a Project's own catalogues, layouts, shapes, tags and presets in its folder beside yours, see which copy is in use, and copy or move them between the Project and your user folder.
While a folder is open as a Project, some of what you keep in your user folder can also have a copy in the Project's .hikari folder. Each place is a tier: Project, the copy in the folder, which everyone who opens the Project gets, and Mine, the copy in your user folder. These have both tiers: style and font catalogues, saved layouts, drawing shapes, tags, the presets of script dialogs, Shift times and the Timing postprocessor, dictionary words, the export format and the translation languages.
Skills: .hikari/skills, shown with Project and Mine chips; they have no Copy or Move. See Skills.
Without a Project, nothing changes: only your own copy is listed, with no chips.
The three rules
How the two tiers combine depends on what they hold:
- Hidden by name. The Project's item hides yours of the same name. Both files stay on disk. Yours is still listed, muted, and its tooltip says Hidden by the project's copy. Choosing it opens it read-only: you can copy or move it, but not change it. Wherever HikariSub looks an item up by name, it finds the Project's first.
- Merged. Both tiers apply together.
- Per key. The Project's value replaces yours, one key at a time.
Catalogues, layouts, shapes, tags and presets are hidden by name. Dictionary words are merged. The export format and translation languages are per key.
In the lists
- Chips and groups. Each row has a Project or a Mine chip, and the list shows This project first, then Mine. A chip beside the list shows the tier of the one you chose.
- Copy and Move. Copy to project or Copy to mine puts a copy in the other tier and keeps this one. Move to project or Move to mine moves it there. If the other tier has one with the same name, a window says so, such as The project already has a catalogue named and the name, and offers Replace, Rename or Skip. Rename suggests a free name, with (2), (3) and so on after it.
- Where new ones go. While a Project is open, the button that makes a new one is split. Its face says Save to project at first. Its arrow, Where to save, switches it to Save to mine or back, and HikariSub remembers the choice for each list. Without a Project, the button saves to your user folder, as before.
- Nothing is written early. Opening a Project adds no files. A folder such as
.hikari/catalogsis made the first time something is saved into it.
Style catalogues
The Project's style catalogues are .hikari/catalogs/<name>.sty in its folder. Yours stay in catalogs in your user folder. In the Style manager:
- Catalogue lists both tiers, with their chips.
- New catalogue has the split button in place of Create. A name the Project already has is taken, in either tier.
- Catalogue tiers, the ⋯ button beside Delete catalogue, copies or moves the catalogue shown. It shows only while a Project is open.
- A catalogue of yours that the Project's hides opens read-only, with Hidden by the project's copy. Copy it to the project to use it there. Its styles can't be changed, and nothing is written to it.
- Your Default catalogue can't be deleted or moved, only copied. The Project's Default can be deleted, and yours shows again, as with any catalogue the Project's hid.
Three things name a catalogue: the file's Last Style Storage line in [Script Info], the catalogue the Style manager had open last, and File › Settings › Conversion › Style › Catalogue. With a Project open, each finds the Project's catalogue of that name first.
Presets
A Project's presets for script dialogs, Shift times and the Timing postprocessor are all in .hikari/presets.toml in its folder. A Project preset hides only yours of the same name in the same list, and for a script dialog, in the same dialog.
- Script dialog presets. The dialog's ⋯ › Presets marks each preset Project or Mine, and a preset of yours that the Project's hides is greyed out. Copy to project, Copy to mine, Move to project and Move to mine are under Delete preset.
- Shift times presets and profiles, and Postprocessor presets. The Preset box groups them under This project and Mine, and its ⋯ menu copies or moves the preset shown. A preset of yours that the Project's hides still applies, but can't be renamed or deleted. The Timing layout's preset is looked up in the Project first.
- Save as preset saves to the Project at first while one is open, with Save to mine on its arrow, and HikariSub remembers the choice for each list.
Font catalogues, layouts, shapes and tags
| List | Where you see it | The Project's copy |
|---|---|---|
| Font catalogues | Manage font catalogues, and every font list that shows a catalogue | .hikari/catalogs/fonts.toml |
| Saved layouts | Save layout as…, Manage layouts… and the layout menu | .hikari/layouts.json |
| Shapes | Edit shapes, and Vector drawing's Shape list | .hikari/shapes.toml |
| Tags | Edit tags, and Hydra's Tag list | .hikari/tags.toml |
Each file is made the first time something is saved into it, in the same format as yours. A Project's item hides yours of the same name, whatever its case.
- The lists show This project first, then Mine. Edit tags shows This project first, and your own tags keep their Common, More and Your tags sections.
- Copy and Move are in each list's menu, such as Layout tiers in Manage layouts, and on a row's right-click menu too. An item of yours that the Project's hides is read-only, but you can still copy, move or delete it.
- New catalogue, New shape and New tag have the split button. Save layout as… has a Save to row instead, which shows This project or Mine: click it for Save to project or Save to mine. HikariSub remembers the choice for each list.
- The layout menu lists the Project's layouts first. A layout of yours that the Project's hides is greyed out, with Hidden by the project's copy. Applying a layout writes nothing to either file.
- Vector drawing's Shape list and Hydra's Tag list offer the Project's first, and never one it hides.
- Yours only. Load from a file, in Manage font catalogues, loads into your own catalogues, and the font catalogues' autosave copies stay in your user folder. Restore default shapes and Restore default tags replace only yours.
Dictionary words
A Project's dictionary words are in .hikari/dictionary.txt, one word per line. They are merged with your personal dictionary: in the Project's windows, spelling and the grammar check accept the words of both, and other windows never accept the Project's.
- The Line editor's menu. Add "…" to dictionary shows where it adds, This project or Mine. While a Project is open, a second item, Add to project dictionary or Add to my dictionary, adds to the other one and remembers that choice.
- The Spellchecker panel. The button says Add to project dictionary or Add to my dictionary. Its arrow, Where to add, switches it, and HikariSub remembers the choice.
- At first words go to the Project's dictionary. The file is made the first time a word is added to it.
Export format and translation languages
These take the Project's value over yours, one setting at a time:
- Export format, on the Export page of the Project tab: Used for files that haven't been exported yet. Not set leaves yours. The
[export]table inproject.tomlcan also hold the Export as window's options. A file's own last export still comes first, then the Project's, then your last export. Exporting never changesproject.toml. - Target language, on the Project tab's Translation page, is the language of Translate to in the Project's windows. Left empty, yours applies. Source language sits beside it, and both Translate to actions send it with the lines. Left empty, it shows Detect, and the models detect the language from the lines.
What stays yours
These have no Project tier, and HikariSub never reads them from a Project folder:
- your shortcuts;
- AI providers, keys and budgets;
- Agent panel threads;
- recent files and window state;
- Hunspell dictionaries, the
.dicand.afffiles.
Projects
See a Project's folder in the Explorer panel, open its files, and rename, trash or add subtitle files there.
Export
Write a copy of your subtitles as SRT, WebVTT, YouTube SBV, plain text, MicroDVD, MPL2, TMPlayer, TTML, DFXP or YouTube timed text (srv3), open srv3 files, and see what each format couldn't keep.