Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
55 commits
Select commit Hold shift + click to select a range
60c7b2b
WIP
onesounds Nov 29, 2021
66de1ae
WIP
onesounds Nov 29, 2021
e8217c5
WIP
onesounds Nov 29, 2021
11cc3bc
Merge branch 'Flow-Launcher:dev' into UpdateReadme
onesounds Nov 29, 2021
53f85a3
WIP
onesounds Nov 30, 2021
1efa536
Merge branch 'UpdateReadme' of https://github.com/onesounds/Flow.Laun…
onesounds Nov 30, 2021
63f3778
WIP
onesounds Dec 2, 2021
436624a
Update README.md
onesounds Dec 2, 2021
2256588
Update README.md
onesounds Dec 2, 2021
b831b69
Add Crowdin img
onesounds Dec 2, 2021
19dd94c
Update README.md
onesounds Dec 3, 2021
f1d41e8
Update README.md
onesounds Dec 3, 2021
ed2b9be
Update README.md
onesounds Dec 3, 2021
044af02
Update README.md
onesounds Dec 3, 2021
fe81e49
Update README.md
onesounds Dec 3, 2021
c16bb8f
Update README.md
onesounds Dec 3, 2021
5fdfe0b
Update README.md
onesounds Dec 3, 2021
8d9e2bb
Update README.md
onesounds Dec 3, 2021
909a3bb
Update README.md
onesounds Dec 3, 2021
0bd6259
Update README.md
onesounds Dec 4, 2021
2187f3f
Update README.md
onesounds Dec 4, 2021
8b81e26
Update README.md
onesounds Dec 4, 2021
a1fc897
Update README.md
onesounds Dec 4, 2021
1dfbd7f
Update README.md
onesounds Dec 4, 2021
915e688
Update README.md
onesounds Dec 4, 2021
6ca67ee
Update README.md
onesounds Dec 4, 2021
2e36d4c
Update README.md
onesounds Dec 4, 2021
5dfcb55
Merge branch 'dev' into UpdateReadme
onesounds Dec 5, 2021
b41ad65
Update README.md
onesounds Dec 6, 2021
b6565c2
Update README.md
onesounds Dec 6, 2021
bd5bb42
Update Readme
onesounds Dec 6, 2021
0b5748a
Update README.md
onesounds Dec 6, 2021
ce4eea8
Update README.md
onesounds Dec 6, 2021
3f5e8e2
Update README.md
onesounds Dec 6, 2021
ba45cb2
Update README.md
onesounds Dec 6, 2021
7d6ad82
Update README.md
onesounds Dec 6, 2021
5f7b5c6
Update README.md
onesounds Dec 6, 2021
abf5caf
Update README.md
onesounds Dec 6, 2021
681092b
Update README.md
onesounds Dec 6, 2021
46ba981
Update README.md
onesounds Dec 6, 2021
b8f1837
Update README.md
onesounds Dec 6, 2021
2db2f7f
Update README.md
onesounds Dec 6, 2021
c3e9441
Update README.md
onesounds Dec 6, 2021
2bd774d
Update README.md
onesounds Dec 6, 2021
8ccd74e
Update README.md
onesounds Dec 6, 2021
c19b6f3
Update README.md
onesounds Dec 6, 2021
4d51d0c
Update README.md
onesounds Dec 6, 2021
67d9bb2
Update README.md
onesounds Dec 7, 2021
9baa89f
Update README.md
onesounds Dec 7, 2021
bda6d53
Update README.md
onesounds Dec 7, 2021
9377d2d
Update README.md
onesounds Dec 7, 2021
5fcdf81
Update README.md
jjw24 Dec 8, 2021
721bce5
Update README.md
jjw24 Dec 8, 2021
95cb429
Update README.md
onesounds Dec 9, 2021
112ae99
formatting
jjw24 Dec 9, 2021
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion Flow.Launcher/SettingWindow.xaml.cs
Original file line number Diff line number Diff line change
Expand Up @@ -365,4 +365,4 @@ private void Window_StateChanged(object sender, EventArgs e)
}

}
}
}
268 changes: 220 additions & 48 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,86 +1,258 @@
<p align="center">
<img src="https://user-images.githubusercontent.com/6903107/144854670-d624d717-d86a-49e5-a5e5-e782f91ed12a.png" width="300"><br />
<a href="https://flow-launcher.github.io">
<img width="500px" src="https://github.com/Flow-Launcher/Flow.Launcher/blob/5ba4514f31e624c679628d4dfe89036c0e24006c/Doc/Logo/resources/flow-header-square-transparent.png">
<img src="https://user-images.githubusercontent.com/6903107/144854052-969f5e60-a0ec-44b8-8968-620467496f10.gif" width="500">
</a>
</p>
<br />

![Maintenance](https://img.shields.io/maintenance/yes/3000)
[![Build status](https://ci.appveyor.com/api/projects/status/32r7s2skrgm9ubva?svg=true&retina=true)](https://ci.appveyor.com/project/JohnTheGr8/flow-launcher/branch/dev)
[![Github All Releases](https://img.shields.io/github/downloads/Flow-Launcher/Flow.Launcher/total.svg)](https://github.com/Flow-Launcher/Flow.Launcher/releases)
![GitHub Release Date](https://img.shields.io/github/release-date/Flow-Launcher/Flow.Launcher)
[![GitHub release (latest by date)](https://img.shields.io/github/v/release/Flow-Launcher/Flow.Launcher)](https://github.com/Flow-Launcher/Flow.Launcher/releases/latest)
[![Documentation](https://img.shields.io/badge/Documentation-7389D8)](https://flow-launcher.github.io/docs)
[![Discord](https://img.shields.io/discord/727828229250875472?color=7389D8&labelColor=6A7EC2&label=Community&logo=discord&logoColor=white)](https://discord.gg/AvgAQgh)
<p align="center">
<img src="https://img.shields.io/maintenance/yes/3000">
<a href="https://crowdin.com/project/flow-launcher"><img src="https://badges.crowdin.net/flow-launcher/localized.svg"></a>
<a href="https://ci.appveyor.com/project/JohnTheGr8/flow-launcher/branch/dev"><img src="https://ci.appveyor.com/api/projects/status/32r7s2skrgm9ubva?svg=true&retina=true"></a>
<a href="https://github.com/Flow-Launcher/Flow.Launcher/releases"><img src="https://img.shields.io/github/downloads/Flow-Launcher/Flow.Launcher/total.svg"></a><br />
<img src="https://img.shields.io/github/release-date/Flow-Launcher/Flow.Launcher">
<a href="https://github.com/Flow-Launcher/Flow.Launcher/releases/latest"><img src="https://img.shields.io/github/v/release/Flow-Launcher/Flow.Launcher"></a>
<a href="https://flow-launcher.github.io/docs"><img src="https://img.shields.io/badge/Documentation-7389D8"></a>
<a href="https://discord.gg/AvgAQgh"><img src="https://img.shields.io/discord/727828229250875472?color=7389D8&labelColor=6A7EC2&label=Community&logo=discord&logoColor=white"></a>
</p>

<p align="center">
Dedicated to making your workflow flow more seamless. Search everything from applications, files, bookmarks, YouTube, Twitter and more. Flow will continue to evolve, designed to be open and built with the community at heart.

<p align="center"> <sub>Remember to star it, flow will love you more :)</sub></p>

<p align="center"><img width="12px" src="https://user-images.githubusercontent.com/26427004/104119722-9033c600-5385-11eb-9d57-4c376862fd36.png"> <a href="https://www.softpedia.com/get/System/Launchers-Shutdown-Tools/Flow-Launcher.shtml">SOFTPEDIA EDITOR'S PICK</a></p>

Flow Launcher. Dedicated to make your workflow flow more seamlessly. Aimed at being more than an app launcher, it searches, integrates and expands on functionalities. Flow will continue to evolve, designed to be open and built with the community at heart.
<img src="https://user-images.githubusercontent.com/6903107/144858082-8b654daf-60fb-4ee6-89b2-6183b73510d1.png" width="100%">

<sub>Remember to star it, flow will love you more :)</sub>

---
## 🎉 New Features in 1.9

![screenshot](https://user-images.githubusercontent.com/6903107/144855345-45535bc7-7777-4c5a-b8d9-d6ce8adc5e84.png)

- All New Design. New Themes, New Setting Window. Animation & Sound Effect, Color Scheme aka Dark Mode.
- New Plugins, Plugin Store, Game Mode, Wizard window
- <a href="https://github.com/Flow-Launcher/Flow.Launcher/releases/tag/v1.9.0">Full changelog</a>

<img src="https://user-images.githubusercontent.com/6903107/144858082-8b654daf-60fb-4ee6-89b2-6183b73510d1.png" width="100%">

<h4 align="center">
<a href="#Features">Features</a> •
<a href="#Getting-Started">Getting Started</a> •
<a href="#Getting-Started">Getting Started</a> • <a href="#Features">Features</a> • <a href="#Plugins">Plugins</a> •
<a href="#Hotkeys">Hotkeys</a> •
<a href="#QuestionsSuggestions">Questions/Suggestions</a> •
<a href="#Development">Development</a> •
<a href="https://flow-launcher.github.io/docs">Documentation</a>
<a href="https://flow-launcher.github.io/docs">Docs</a>
</h4>

---
<img src="https://user-images.githubusercontent.com/6903107/144858082-8b654daf-60fb-4ee6-89b2-6183b73510d1.png" width="100%">

## Features
## 🚗 Getting Started

### Installation

| [Windows 7+ installer](https://github.com/Flow-Launcher/Flow.Launcher/releases/latest/download/Flow-Launcher-Setup.exe) | [Portable](https://github.com/Flow-Launcher/Flow.Launcher/releases/latest/download/Flow-Launcher-Portable.zip) | `WinGet install "Flow Launcher"` |
| :----------------------------------------------------------: | :----------------------------------------------------------: | :------------------------------: |

> Windows may complain about security due to code not being signed, this will be completed at a later stage. If you downloaded from this repo, you are good to continue the set up.

And you can download <a href="https://github.com/Flow-Launcher/Flow.Launcher/discussions" target="_blank">early access version</a>.

<img src="https://user-images.githubusercontent.com/6903107/144858082-8b654daf-60fb-4ee6-89b2-6183b73510d1.png" width="100%">

## 🎁 Features

### Applications & Files

<img src="https://user-images.githubusercontent.com/6903107/145332614-74909973-f6eb-47c2-8235-289931e30718.png" width="400">


- Search for files or their contents.

<img src="https://user-images.githubusercontent.com/6903107/145018796-658b7c24-a34f-46b6-98d4-cf4f636d8b60.png" width="400">

![The Flow](https://user-images.githubusercontent.com/26427004/82151677-fa9c7100-989f-11ea-9143-81de60aaf07d.gif)

- Search everything from applications, files, bookmarks, YouTube, Twitter and more. All from the comfort of your keyboard without ever touching the mouse.
- Search for file contents.
- Do mathematical calculations and copy the result to clipboard.
- Support search using environment variable paths.

### Web Search & Open URL

<img src="https://user-images.githubusercontent.com/6903107/144517502-5325de01-d0d9-4c2e-aafb-33c3f5d82f81.png" width="400">
<img src="https://user-images.githubusercontent.com/6903107/144831031-0e01e8ea-3247-4ba4-a7b4-48b0db620bc1.png" width="400">
<img src="https://user-images.githubusercontent.com/6903107/144517519-79ee8a81-083c-42be-b2d7-4990d1cb53e5.png" width="400">

### Browser Bookmarks

<img src="https://user-images.githubusercontent.com/6903107/144517534-5e27547b-77f8-4718-941c-5bc542eed931.png" width="400">

### System Commands

<img src="https://user-images.githubusercontent.com/6903107/144517557-9b5b82fc-6408-48a0-af59-69b385a0782e.png" width="400">

- Provides System related commands. shutdown, lock, settings, etc.
- <a href="#system-command-list">System command list</a>

### Calculator

<img src="https://user-images.githubusercontent.com/6903107/144517570-f0e62716-3fdf-4f2a-8986-385a3fcd0663.png" width="400">

- Do mathematical calculations and copy the result to clipboard.

### Shell Command

<img src="https://user-images.githubusercontent.com/6903107/144517582-83da8414-e03d-402c-863d-22d116d20c31.png" width="400">

- Run batch and PowerShell commands as Administrator or a different user.
- Support languages from Chinese to Italian and more.
- Support wide range of plugins.
- Prioritise the order of each plugin's results.
- Ctrl+Enter to Run as Administrator.

### Explorer

<img src="https://user-images.githubusercontent.com/6903107/144517603-7bfbf868-476a-41d1-bd1b-1ebde7ab2539.png" width="400">

- Save file or folder locations for quick access.
- Fully portable.

[<img width="12px" src="https://user-images.githubusercontent.com/26427004/104119722-9033c600-5385-11eb-9d57-4c376862fd36.png"> **SOFTPEDIA EDITOR'S PICK**](https://www.softpedia.com/get/System/Launchers-Shutdown-Tools/Flow-Launcher.shtml)
### Window Setting & Control Panel

## Getting Started
<img src="https://user-images.githubusercontent.com/6903107/144982305-42a2f63e-0066-4557-9791-0a1c57495ea7.png" width="400">

### Installation
- Search within Window Settings & Control Panel.

| [Windows 7+ installer](https://github.com/Flow-Launcher/Flow.Launcher/releases/latest/download/Flow-Launcher-Setup.exe) | [Portable](https://github.com/Flow-Launcher/Flow.Launcher/releases/latest/download/Flow-Launcher-Portable.zip) | `WinGet install "Flow Launcher"` |
| --------------------------------- | --------------------------------- | --------------------------------- |

Windows may complain about security due to code not being signed, this will be completed at a later stage. If you downloaded from this repo, you are good to continue the set up.
### Priority

<img src="https://user-images.githubusercontent.com/6903107/144517677-857a2b0a-4b94-4be0-bc89-f35723ecddf9.png" width="500">


- Prioritise the order of each plugin's results.

### Customization

![Animation5](https://user-images.githubusercontent.com/6903107/144693887-1b92ed16-dca1-4b7e-8644-5e9524cdfb31.gif)

- Window size adjustment, animation, and sound
- Color Scheme (aka Dark Mode)

![themes](https://user-images.githubusercontent.com/6903107/144527796-7c06ca31-d933-4f6b-9eb0-4fb06fa94384.png)

### Usage
- Open flow's search window: <kbd>Alt</kbd>+<kbd>Space</kbd> is the default hotkey.
- Open context menu: on the selected result, press <kbd>Ctrl</kbd>+<kbd>O</kbd>/<kbd>Shift</kbd>+<kbd>Enter</kbd>.
- Cancel/Return to previous screen: <kbd>Esc</kbd>.
- Install/Uninstall/Update plugins: in the search window, type `pm` `install`/`uninstall`/`update` + the plugin name.
- There are various themes and you can make it yourself.

### 💬 Language

- Support languages from Chinese to Italian and more.
- Support Pinyin.
- Translation support this project in [Crowdin](https://crowdin.com/project/flow-launcher)

### Portable

- Fully portable.
- Type `flow user data` to open your saved user settings folder. They are located at:
- If using roaming: `%APPDATA%\FlowLauncher`
- If using portable, by default: `%localappdata%\FlowLauncher\app-<VersionOfYourFlowLauncher>\UserData`
- Type `open log location` to open your logs folder, they are saved along with your user settings folder.
- Type `open log location` to open your logs folder, they are saved along with your user settings folder.

### 🎮 Game Mode

<img src="https://user-images.githubusercontent.com/6903107/144517711-a7396bbb-f7ae-403d-9644-1414edd9e3f1.png" width="150">

- Suspend the hotkey when you are playing games.

<img src="https://user-images.githubusercontent.com/6903107/144858082-8b654daf-60fb-4ee6-89b2-6183b73510d1.png" width="100%">

## 📦 Plugins

- Support wide range of plugins. Visit [here](https://flow-launcher.github.io/docs/#/plugins) for our plugin portfolio.
- If you are using Python plugins, flow will prompt to either select the location or allow Python (Embeddable) to be automatic downloaded for use.
- Create and publish your own plugin to flow! Take a look at our plugin development documentation for [C#](https://flow-launcher.github.io/docs/#/develop-dotnet-plugins) or [Python](https://flow-launcher.github.io/docs/#/develop-py-plugins)

### Everything
<img src="https://user-images.githubusercontent.com/6903107/144533510-6880ecf4-5f93-4b6a-9c1f-4fcdb99110c3.png" width="400">

### SpotifyPremium
<img src="https://user-images.githubusercontent.com/6903107/144533469-da920295-8c36-46e8-89eb-a9cdd94b74ef.png" width="400">


### Steam Search
<img src="https://user-images.githubusercontent.com/6903107/144533523-afd79dca-a444-40e5-b2d9-6d3fe3aaece1.png" width="400">


### Clipboard History
<img src="https://user-images.githubusercontent.com/6903107/144533481-58e473fd-38d9-4604-861f-ad870770967d.png" width="400">

### Home Assistant Commander
<img src="https://user-images.githubusercontent.com/6903107/144533538-3caa2944-3037-4755-87b9-70fa918d2efa.png" width="400">

### Colors

<img src="https://user-images.githubusercontent.com/6903107/144533487-2caff162-a8f6-4577-af3f-d1b05d423ee4.png" width="400">

### Github
<img src="https://user-images.githubusercontent.com/6903107/144533497-8677f800-95c5-4758-8ca3-c96333ee1943.png" width="400">

### Windows Walker
<img src="https://user-images.githubusercontent.com/6903107/144533517-07bf011f-726c-4221-8657-0e442eca8a82.png" width="400">

......and <a href="https://flow-launcher.github.io/docs/#/plugins">more!</a>

<img src="https://user-images.githubusercontent.com/6903107/144858082-8b654daf-60fb-4ee6-89b2-6183b73510d1.png" width="100%">

### 🛒 Plugin Store

![pluginstore](https://user-images.githubusercontent.com/6903107/144528115-3b6baa89-f53f-40db-8426-02c4db8dd2b5.png)

- You can view the full plugin list or quickly install a plugin via the Plugin Store menu in Settings

- or type `pm` `install`/`uninstall`/`update` + the plugin name in the search window,


<img src="https://user-images.githubusercontent.com/6903107/144858082-8b654daf-60fb-4ee6-89b2-6183b73510d1.png" width="100%">

## ⌨️ Hotkeys

[More tips](https://flow-launcher.github.io/docs/#/usage-tips)
| Hotkey | Description |
| ------------------------------------------------------------ | -------------------------------------------- |
| <kbd>Alt</kbd>+ <kbd>Space</kbd> | Open Search Box (Default and Configurable) |
| <kbd>Enter</kbd> | Execute |
| <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Enter</kbd> | Run As Admin |
| <kbd>↑</kbd><kbd>↓</kbd> | Scroll up & Down |
| <kbd>←</kbd><kbd>→</kbd> | Back to Result / Open Context Menu |
| <kbd>Ctrl</kbd> +<kbd>o</kbd> , <kbd>Shift</kbd> +<kbd>Enter</kbd> | Open Context Menu |
| <kbd>Tab</kbd> | Autocomplete |
| <kbd>Esc</kbd> | Back to Result & Close |
| <kbd>Ctrl</kbd> +<kbd>i</kbd> | Open Setting Window |
| <kbd>F5</kbd> | Reload All Plugin Data & Window Search Index |
| <kbd>Ctrl</kbd> + <kbd>h</kbd> | Open Query History |

### Plugins

Flow searches files and contents via Windows Index Search, to use **Everything**: `pm install everything`.
## System Command List

If you are using Python plugins, flow will prompt to either select the location or allow Python (Embeddable) to be automatic downloaded for use.
| Command | Description |
| ---------------------- | ------------------------------------------------------------ |
| Shutdown | Shutdown computer |
| Restart | Restart computer |
| Restart with advance | Restart the computer with Advanced Boot option for safe and debugging modes |
| Log off | Log off |
| Lock | Lock computer |
| Sleep | Put computer to sleep |
| Hibernate | Hibernate computer |
| Empty Recycle Bin | Empty recycle bin |
| Exit | Close Flow Launcher |
| Save Settings | Save all Flow Launcher settings |
| Restart Flow Launcher | Restart Flow Launcher |
| Settings | Tweak this app |
| Reload Plugin Data | Refreshes plugin data with new content |
| Check For Update | Check for new Flow Launcher update |
| Open Log Location | Open Flow Launcher's log location |
| Flow Launcher Tip | Visit Flow Launcher's documentation for more help and how to use tips |
| Flow Launcher UserData | Open the location where Flow Launcher's settings are stored |

Vist [here](https://flow-launcher.github.io/docs/#/plugins) for our plugin portfolio.
### 💁‍♂️ Tips

If you are keen to write your own plugin for flow, please take a look at our plugin development documentation for [C#](https://flow-launcher.github.io/docs/#/develop-dotnet-plugins) or [Python](https://flow-launcher.github.io/docs/#/develop-py-plugins)
- [More tips](https://flow-launcher.github.io/docs/#/usage-tips)

## Questions/Suggestions
<img src="https://user-images.githubusercontent.com/6903107/144858082-8b654daf-60fb-4ee6-89b2-6183b73510d1.png" width="100%">

Yes please, let us know in the [Q&A](https://github.com/Flow-Launcher/Flow.Launcher/discussions/categories/q-a) section.
## ❔ Questions/Suggestions

**Join our community on [Discord](https://discord.gg/AvgAQgh)!**
Yes please, let us know in the [Q&A](https://github.com/Flow-Launcher/Flow.Launcher/discussions/categories/q-a) section. **Join our community on [Discord](https://discord.gg/AvgAQgh)!**

## Development

Expand All @@ -98,8 +270,8 @@ Get in touch if you like to join the Flow-Launcher Team and help build this grea

### Developing/Debugging

Flow Launcher's target framework is .Net 5
- Flow Launcher's target framework is .Net 5

Install Visual Studio 2019
- Install Visual Studio 2019

Install .Net 5 SDK via Visual Studio installer or manually from [here](https://dotnet.microsoft.com/download/dotnet/thank-you/sdk-5.0.103-windows-x64-installer)
- Install .Net 5 SDK via Visual Studio installer or manually from [here](https://dotnet.microsoft.com/download/dotnet/thank-you/sdk-5.0.103-windows-x64-installer)