Finicky v4 — anything we need to know to upgrade?

[glasser]

Is there any sort of upgrade guide for v4, or anything one should know before installing it? Anything needs to change in our config file?

[johnste]

For the most part Finicky 4 should be backwards compatible.

For the things that are renamed or unavailable, Finicky will report deprecation warnings or errors for unsupported features.

I'll write a short upgrade guide for these things.

[raymond1138]

I haven't upgraded yet because I use opener matches and I get warnings that it's no longer supported. For example:

match: (url) => (url.opener.name === "Asana"),
browser: "Microsoft Edge",

Since I only use Asana for work and have all my work accounts signed in in Edge, this does exactly what I need it to but in 4.0.0-beta.3, I get this warning:

Accessing legacy property "opener" that is no longer supported.

Is there a way to update my matches or am I stuck not upgrading?

[johnste]

Hey @raymond1138

Opener still exists, but it's now part of the second argument to the helper functions (match, browser, and url), so your example config could be updated to this:

match: (url, { opener }) => (opener.name === "Asana"),
browser: "Microsoft Edge",

This is documented here in the wiki but the warning message in the app isn't very specific unfortunately.

[raymond1138]

OK, thanks! I suspected as much but my developer skills were just enough out-of-date that I couldn't sort how to translate it. Appreciate the quick response and your hard work on the project!

[e40]

I just upgraded to v4.1.0 and a couple of things:

• the main window says "New Version Available" and says that version is v4.1.0, but I have that
• I don't see a menubar icon anymore ... which allowed me to edit the config, etc ... I found that very handy ... is this problem unique to me?

[johnste]

Menu bar icon had been removed. Starting finicky as a normal app (via spotlight for example) opens the debug / configuration window.

…

-------- Original Message --------

On 2025-05-29 22:39, e40 wrote: I just upgraded to v4.1.0 and a couple of things: - the main window says "New Version Available" and says that version is v4.1.0, but I have that - I don't see a menubar icon anymore ... which allowed me to edit the config, etc ... I found that very handy ... is this problem unique to me? — Reply to this email directly, [view it on GitHub](#378 (comment)), or [unsubscribe](https://github.com/notifications/unsubscribe-auth/AAGYKI7N5TN34GMOX6XHKUT3A5WBBAVCNFSM6AAAAABZSJFYWSVHI2DSMVQWIX3LMV43URDJONRXK43TNFXW4Q3PNVWWK3TUHMYTGMZRGM4DONQ). You are receiving this because you commented.Message ID: ***@***.***>

[e40]

finicky as a normal app (via spotlight for example) opens the debug / configuration window.

Are you saying I should be able to edit the config from that window? I don't see how.

[e40]

Also, I don't see it running in the Dock, let it seems to be active. Does that mean when I click on URLs in, say, slack it starts Finicky and goes to the right browser and the exits?

[nisc]

Menu bar icon had been removed. Starting finicky as a normal app (via spotlight for example) opens the debug / configuration window.

I'm curious, why remove the menu bar icon? I also found it handy.

[jimhelman]

@nisc Me too. It takes up less space in the menu bar than having it sit in the dock. And on first use (invoked from CLI or Finder), I always get a superfluous window that I need to minimize to the Dock. Or am I missing a way to configure it to be better behaved? For now, I'm back on Finicky 3.

[johnste]

You don't need to run Finicky manually (except the first time, or whenever you want to use the window).

That being said, I think I will be exploring ways to restore the previous way Finicky was running, in the background with a menu bar icon, as an optional behavior in 4.

[johnste]

There might be a bug in displaying the most up to date version 4.1.0 is indeed the latest one.

…

-------- Original Message --------

On 2025-05-29 22:45, John Sterling wrote: Menu bar icon had been removed. Starting finicky as a normal app (via spotlight for example) opens the debug / configuration window. -------- Original Message -------- On 2025-05-29 22:39, e40 wrote: > I just upgraded to v4.1.0 and a couple of things: > > - the main window says "New Version Available" and says that version is v4.1.0, but I have that > - I don't see a menubar icon anymore ... which allowed me to edit the config, etc ... I found that very handy ... is this problem unique to me? > > — > Reply to this email directly, [view it on GitHub](#378 (comment)), or [unsubscribe](https://github.com/notifications/unsubscribe-auth/AAGYKI7N5TN34GMOX6XHKUT3A5WBBAVCNFSM6AAAAABZSJFYWSVHI2DSMVQWIX3LMV43URDJONRXK43TNFXW4Q3PNVWWK3TUHMYTGMZRGM4DONQ). > You are receiving this because you commented.Message ID: ***@***.***>

[e40]

That's what I see. Is that correct?

[johnste]

Yes, this is correct. There's a bug here where it reports a new update being available even though we are on the latest version, and I'll create an issue to deal with it

[johnste]

Ah, no. To edit the configuration file you need to open it manually. Could probably bring this feature back in the window if there's a need for it.

…

-------- Original Message --------

On 2025-05-29 22:50, e40 wrote: > finicky as a normal app (via spotlight for example) opens the debug / configuration window. > # Are you saying I should be able to edit the config from that window? I don't see how. — Reply to this email directly, [view it on GitHub](#378 (reply in thread)), or [unsubscribe](https://github.com/notifications/unsubscribe-auth/AAGYKIZFNR47OQNKWU53MKT3A5XJFAVCNFSM6AAAAABZSJFYWSVHI2DSMVQWIX3LMV43URDJONRXK43TNFXW4Q3PNVWWK3TUHMYTGMZRGM4TIMA). You are receiving this because you commented.Message ID: ***@***.***>

[johnste]

If this gets added it will definitely be as an optional feature

[glasser]

I'm happy with Finicky not taking up space in my menu bar. It would be nice to be able to click a button in the app to open the config file like I used to, though since the app tells you where the file is that's pretty good too.

[gregschroeder]

is there an equivalent of the console, where you could test how URLs would resolve?

[johnste]

There's no console in Finicky 4 (at least not yet).

You can run Finincky in dry-run mode (where it doesn't open any browsers) by running it from the terminal like so:
/Applications/Finicky.app/Contents/MacOS/Finicky --dry-run --window

The Finicky window should open, and any url you try to open wouldn't and would log to the window instead (many as debug logs, so make sure to enable their visibility by clicking 'Show Debug')

[gregschroeder]

ok, thanks, that'll work (although I've made heavy use of the console for refining patterns)