Skip to content

Commit

Permalink
Installation guide: Mention slow first launch time (#253)
Browse files Browse the repository at this point in the history
# 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!
  • Loading branch information
psobolewskiPhD authored Oct 27, 2023
1 parent 0722b40 commit 0b657a7
Showing 1 changed file with 7 additions and 0 deletions.
7 changes: 7 additions & 0 deletions docs/tutorials/fundamentals/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 expected and subsequent
launches should be quick. However, anti-malware and other security software
measures may further delay launches—even after the first launch.
````

## Choosing a different Qt backend

napari needs a library called [Qt](https://www.qt.io/) to run its user interface
Expand Down

0 comments on commit 0b657a7

Please sign in to comment.