|
1 | | -Visual Studio for Flow Launcher |
2 | | -================== |
| 1 | +<p align="center"> |
| 2 | + <a href="https://flowlauncher.com"> |
| 3 | + <img src="doc/flow.png" width=12.5%> |
| 4 | + </a> |
| 5 | + <a href="https://visualstudio.microsoft.com"> |
| 6 | + <img src= "doc/vs_2022.png" width=12.5%> |
| 7 | + </a> |
| 8 | +</p> |
3 | 9 |
|
4 | | -A [Flow launcher](https://github.com/Flow-Launcher/Flow.Launcher) to let you quickly open your recent projects, solutions and files in Visual Studio |
| 10 | +<h1 align="center">Visual Studio for Flow Launcher</h1> |
5 | 11 |
|
6 | | -### Usage |
| 12 | +A [Flow launcher](https://github.com/Flow-Launcher/Flow.Launcher) plugin to let you quickly open your recent Visual Studio projects, solutions and files, as well as remove those pesky entries that exist no more! |
7 | 13 |
|
8 | | - [ <arguments> |
| 14 | +## Installation |
| 15 | +Type |
| 16 | +``` |
| 17 | +pm install Visual Studio Launcher |
| 18 | +``` |
| 19 | +in Flow Launcher. |
| 20 | +> [!IMPORTANT] |
| 21 | +> Requires at least Flow Launcher version 1.16. |
| 22 | +
|
| 23 | +## Features |
| 24 | +### Searching |
| 25 | + |
| 26 | +Search all your recent items from **all** your Visual Studio installations. |
| 27 | + |
| 28 | +| Command | Description | |
| 29 | +| :-------------------- | :--------------------------------------------------------- | |
| 30 | +| `[ {your search}` | Search all recent items (if empty shows all). | |
| 31 | +| `[ p: {your search}` | Search only recent projects (if empty shows all projects). | |
| 32 | +| `[ f: {your search}` | Search only recent files (if empty shows all files). | |
| 33 | + |
| 34 | + |
| 35 | + |
| 36 | +> [!NOTE] |
| 37 | +> Theoretically works with any number of Visual Studio installations, provided they are Visual Studio 2017 version 15.2 or later, as it requires [vswhere](https://github.com/microsoft/vswhere). |
| 38 | +
|
| 39 | +### Context Menu |
| 40 | + |
| 41 | +Press <kbd>⇧ Shift</kbd> + <kbd>⇥ Tab</kbd> or right-click on a search result (a recent item) to open the context menu shown below. |
| 42 | + |
| 43 | +This allows for: |
| 44 | +- Opening the item in a specific installation of Visual Studio. |
| 45 | +- Removing the item from Visual Studio's recent items list. |
| 46 | +- Opening the item in your default file manager. |
| 47 | + |
| 48 | + |
| 49 | + |
| 50 | +> [!NOTE] |
| 51 | +> The recent items list is ***shared*** between all your Visual Studio installations (although it can get out of sync), therefore, if you remove an item, it removes it from **all** Visual Studio installations recent item list. |
| 52 | +
|
| 53 | +### Settings |
| 54 | + |
| 55 | + |
| 56 | + |
| 57 | +1. The default Visual Studio installation to open a search result with (when you press <kbd>⏎ Enter</kbd> or left-click). Clicking shows a dropdown of all the Visual Studio installations found on your system. |
| 58 | +2. Refresh the list of Visual Studio installations. |
| 59 | +3. Clear invalid items from the recent items list i.e. if the path to said item does not exist remove it. |
| 60 | +4. Removes all items from the recent items list. |
| 61 | +5. Manage the backup (by default the backup is updated once a day, provided Flow Launcher has been launched that day). |
| 62 | + 1. Restore recent items to the current backup |
| 63 | + 2. Backup recent items right now |
| 64 | + 3. Stop automatically updating the backup |
| 65 | + |
| 66 | +## Known Issues |
| 67 | + |
| 68 | +- Sometimes the icons for each Visual Studio installation in the [context menu](#context-menu) are not shown, restarting Flow Launcher should fix the issue. |
| 69 | + |
| 70 | +## Acknowledgements |
| 71 | + |
| 72 | +- This [blog post](https://www.thomasbogholm.net/2021/06/18/pruning-recent-projects-in-start-page-of-visual-studio-2019-open-recent/) on where the recent items in Visual Studio are actually stored. |
| 73 | +- The [Visual Studio Code plugin](https://github.com/taooceros/Flow.Plugin.VSCodeWorkspace) for Flow Launcher. |
| 74 | +- Microsoft for the Visual Studio icons. |
| 75 | +- [Icons8](https://icons8.com/) for the other icons. |
0 commit comments