Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Installation guide: Mention slow first launch time #253

Merged
merged 2 commits into from
Oct 27, 2023

Conversation

psobolewskiPhD
Copy link
Member

References and relevant issues

Closes #222

Description

This PR adds a Note that first launch may be slow on some platforms (macOS, Windows) and that anti-malware and security software may also result in slower launches.
It's quite disconcerting when running napari doesn't visually do anything immediately!

@psobolewskiPhD psobolewskiPhD added documentation Improvements or additions to documentation content Ideas for new or improved content labels Oct 26, 2023
@psobolewskiPhD psobolewskiPhD added this to the 0.4.19 milestone Oct 26, 2023
@psobolewskiPhD psobolewskiPhD requested a review from Czaki October 26, 2023 00:44
@@ -170,6 +170,13 @@ the current release {{ napari_version }}, using command: `napari --version` .
````
![macOS desktop with a napari viewer window without any image opened in the foreground, and a terminal in the background with the appropriate conda environment activated (if applicable) and the command to open napari entered.](../assets/tutorials/launch_cli_empty.png)

````{note}
On some platforms, particularly macOS and Windows, there may be a ~30 second
delay before the viewer appears on first launch. This is normal and subsequent
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't know if I woudl call it "normal", but I get your point xD

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would you prefer "common" ?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would rather point out that this is an issue with those platforms, cause as it is it sounds like there's not expectation/hope of this to get fixed.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I mean there isn't anything we can do, so it's not a napari issue, which was the point of this Note.

Copy link
Member

@melissawm melissawm left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me!

@jni jni merged commit 0b657a7 into napari:main Oct 27, 2023
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
content Ideas for new or improved content documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Warn that first run of napari after install is slow (~30 s)
4 participants