Expose --title-format option

[rieje]

yazi --debug output

N/A

Please describe the problem you're trying to solve

Currently, title_format can only be set at yazi.toml, but it seems to make more sense to expose this as a CLI option available in most applications that let you set this.

Use case: looking to use Yazi as an XDG file picker for applications. When used as a file picker, I want to define a window rule for my tiling window manager that opens Yazi in a floating window instead of as a default tiling window. The way to achieve this is to set a window name that can be captured by the window manager to apply the rule, such as giving the window of an application a prefix to match for, e.g. "File picker: {cwd}". With a yazi --title-format "File picker: {cwd}" this is trivial; currently, it looks like one needs to maintain two yazi.toml config files--one for typical Yazi usage and the other YAZI_CONFIG_HOME for Yazi as a file picker.

Would you be willing to contribute this feature?

• Yes, I'll give it a shot

Describe the solution you'd like

Expose --title-format CLI option.

Additional context

No response

Checklist

• I have searched the existing issues/discussions
• The latest nightly build doesn't already have this feature

[github-actions]

Hey @rieje, I noticed that you did not correctly follow the issue template. Please ensure that:

• The requested feature does not exist in the newest nightly build.
• The debug information (yazi --debug) is updated for the newest nightly.
• The non-optional items in the checklist are checked.

Issues with needs info will be marked ready once edited with the proper content, or closed after 2 days of inactivity.

[sxyazi]

I plan to deprecate the title_format config from yazi.toml and reintroduce it in Lua, which is exactly to address this issue - the existing title_format is not flexible enough as it can only use a limited set of variables (currently only {cwd}), and it doesn't allow users to further control its behavior as needed, i.e. in your case, you want to use a different title content when running Yazi as a file picker.

Note that your original request is a duplicate of #2047. Currently, there's still no progress on it (no one has been able to work on it yet, unfortunately), which means that before a solution is figured out, new CLI options like --title-format will not be added to avoid the possibility of introducing breaking changes and having to rework things in the future.