Implement Toast

[JPKribs]

Describe the feature you'd like
Do we want to enable toast on Swiftfin? If so, what is the best provider for toast? My quick google found:

• https://github.com/quanshousio/ToastUI
• https://github.com/elai950/AlertToast

We could also just use alerts but I don't love doing notifications on a blocking popup.

Additional context
I'm feeling really good about potentially getting the websocket knocked out soon. When this is done, this opens us up to a lot of options (SyncPlay, Swiftfin usable as remote, more-reactive home screen, etc.) but I think the easiest thing is to implement toast for admin messages from server. Additionally, we can use this for the websocket "server shutting down" messages as well. I'm not sure what else we'd want to toast but I'm sure there are some other usages.

Considerations

• Does the value vs effort make sense?
• Would we want this on just iOS or tvOS as well?

[JPKribs]

Here is my first round of trying to get this working. Looking for feedback! I feel like this is really close to a final version. My biggest gripe is that the progress bar and the test of the toast disconnect when it moves. This is currently only for iOS

Branch: https://github.com/JPKribs/Swiftfin/tree/toast

iPadOS

Simulator.Screen.Recording.-.iPad.Pro.13-inch.M4.-.2025-05-14.at.15.18.57.mp4

iOS

Simulator.Screen.Recording.-.iPhone.16.Pro.-.2025-05-14.at.15.22.40.mp4

The way I have this working is that toasts that expire / time out and are not dismissed are kept. So, there would also be like a "Notification" section in the settings with notifications:

NotificationView

Simulator.Screen.Recording.-.iPhone.16.Pro.-.2025-05-14.at.16.57.10.mp4

[ryanh2o3]

Here is my first round of trying to get this working. Looking for feedback! I feel like this is really close to a final version. My biggest gripe is that the progress bar and the test of the toast disconnect when it moves. This is currently only for iOS

Branch: https://github.com/JPKribs/Swiftfin/tree/toast

iPadOS
iOS
The way I have this working is that toasts that expire / time out and are not dismissed are kept. So, there would also be like a "Notification" section in the settings with notifications:

NotificationView

Cool. Tried it on my phone, works well. Only comment I'd make is that when I open multiple in quick succession the timeout progress bar doesn't move up with the rest of the toast, it kind of jumps (at least that's how it appears to my eyes); its not really much of an issue though.

[JPKribs]

Only comment I'd make is that when I open multiple in quick succession the timeout progress bar doesn't move up with the rest of the toast

I was getting that too! I just resolved that in my latest commit if you want to test:

Simulator.Screen.Recording.-.iPhone.16.Pro.-.2025-05-15.at.14.08.09.mp4

I think the toast part is ready to go now but I always love feedback. Most recent changes are the detaching toast and progress + a notification page:

Put a bell to indicate there are notifications that weren't dismissed:

Along with a view to see/dismiss old notifications:

---

I'm at a work conference this week so I really wasn't expecting to work on this but this actually came together really quickly. That being said, I'd probably want confirmation we WANT toasts in Swiftfin before I localize everything and clean it up.

[ryanh2o3]

Only comment I'd make is that when I open multiple in quick succession the timeout progress bar doesn't move up with the rest of the toast

I was getting that too! I just resolved that in my latest commit if you want to test:

Simulator.Screen.Recording.-.iPhone.16.Pro.-.2025-05-15.at.14.08.09.mp4

I think the toast part is ready to go now but I always love feedback. Most recent changes are the detaching toast and progress + a notification page:

Put a bell to indicate there are notifications that weren't dismissed:

Along with a view to see/dismiss old notifications:

I'm at a work conference this week so I really wasn't expecting to work on this but this actually came together really quickly. That being said, I'd probably want confirmation we WANT toasts in Swiftfin before I localize everything and clean it up.

cool, I'll give it a try. I definitely think there are uses to having the toasts, besides the button I create to test them :).

[JPKribs]

Totally agree! I have websocket support functional here so we could use this for:

• Messages from Jellyfin Admin Dashboard
• SyncPlay messages
• Task notifications
• Server shutdown messages

I'd argue this toasts part can be done before websocket but I think before this is ready I'd need to:

• tvOS Implementation (Probably toast in the top right corner?)
• tvOS NotificationView
• Vet iPad works well with the iOS Toast
• Localizations

I also have one last bug on iOS where the NotificationView count and the bell don't appropriately update when the ToastManager is empty. Either I am using Factory wrong or I am calling Factory wrong.

But, I'm a bit overextended with PRs right now. I started this just as a POC and this came together a lot faster than I thought it would. I was kind of hoping someone else would have bandwidth to take ownership of this but I might be in too deep for someone to be able to pick this up and run with it haha

[ryanh2o3]

yeah that's much smoother now. my eyes definitely weren't deceiving me before. I think the bell icon is better for the notifications menu, I am noticing that if you go in and delete notifications, the number of notifications doesn't change when you go back to the profile, it only does when you go to settings then back into the profile so might want to look at a forced re-render or something.

[ryanh2o3]

Totally agree! I have websocket support functional here so we could use this for:

• Messages from Jellyfin Admin Dashboard
• SyncPlay messages
• Task notifications
• Server shutdown messages

I'd argue this toasts part can be done before websocket but I think before this is ready I'd need to:

• tvOS Implementation (Probably toast in the top right corner?)[ ] tvOS NotificationView[ ] Vet iPad works well with the iOS Toast[ ] Localizations

I also have one last bug on iOS where the NotificationView count and the bell don't appropriately update when the ToastManager is empty. Either I am using Factory wrong or I am calling Factory wrong.

But, I'm a bit overextended with PRs right now. I started this just as a POC and this came together a lot faster than I thought it would. I was kind of hoping someone else would have bandwidth to take ownership of this but I might be in too deep for someone to be able to pick this up and run with it haha

definitely lots of uses.

yeah no reason to not just do toasts now.
tvOS in top right yep.

haha same bug I noticed

I could give it a go, I've got into swift a lot more with my other app recently and have been wanting to actually properly contribute to Swiftfin (beyond my 2 or so tiny PRs like a year ago)....but you have got most of this done tbh

[JPKribs]

I could give it a go, I've got into swift a lot more with my other app recently and have been wanting to actually properly contribute to Swiftfin

If you want to that would be awesome! I'm at 9 open PRs in Swiftin and 2 open on the SDK so I'm trying to avoid opening new things up until those are wrapped up since I'm sure there are some revisions needed. If you have the bandwidth and want to get this over the finish line that would be a huge assist!

[ryanh2o3]

I could give it a go, I've got into swift a lot more with my other app recently and have been wanting to actually properly contribute to Swiftfin

If you want to that would be awesome! I'm at 9 open PRs in Swiftin and 2 open on the SDK so I'm trying to avoid opening new things up until those are wrapped up since I'm sure there are some revisions needed. If you have the bandwidth and want to get this over the finish line that would be a huge assist!

Cool! Yeah that's a lot of PRs.
I should be able to get something done at the weekend.
Want me to work off my own version of your branch?

[JPKribs]

Want me to work off my own version of your branch?

Totally your call! I'm not a developer by trade so anything fancy with git is beyond me. I'd say make your own branch and your welcome to pick and choose anything from my branch you want. I don't care about attribution lol so don't spend any extra effort trying to loop me in. I'm just happy to see Swiftfin get new features. So, whatever is easiest for you, do that!

[ryanh2o3]

Want me to work off my own version of your branch?

Totally your call! I'm not a developer by trade so anything fancy with git is beyond me. I'd say make your own branch and your welcome to pick and choose anything from my branch you want. I don't care about attribution lol so don't spend any extra effort trying to loop me in. I'm just happy to see Swiftfin get new features. So, whatever is easiest for you, do that!

Cool cool. Hopefully I get something up in a few days.

[JPKribs]

As part of the PR, I think it would be good to link Toast to ServerTasksViewModel. Specifically, I think injecting ToastManager and having a warning message on restart/shutdown. We have a TODO in there (meaning toast is definitely a goal) so that would be a good usage of it as a starting point IMO.

If you have any questions feel free to ping me and I can try to help out. Thank you again for taking this one on!