Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/end2endzone/shellanything
ShellAnything is a C++ open-source software which allow one to easily customize and add new options to *Windows Explorer* context menu. Define specific actions when a user right-click on a file or a directory.
https://github.com/end2endzone/shellanything
context-menu contextmenu explorer file-explorer menu-customization menu-personalize personalize shell-extension utf-8 windows windows-explorer windows-shell windows-shell-extension
Last synced: 4 days ago
JSON representation
ShellAnything is a C++ open-source software which allow one to easily customize and add new options to *Windows Explorer* context menu. Define specific actions when a user right-click on a file or a directory.
- Host: GitHub
- URL: https://github.com/end2endzone/shellanything
- Owner: end2endzone
- License: mit
- Created: 2019-03-08T20:50:10.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-09-12T02:59:15.000Z (5 months ago)
- Last Synced: 2024-09-12T12:11:13.773Z (5 months ago)
- Topics: context-menu, contextmenu, explorer, file-explorer, menu-customization, menu-personalize, personalize, shell-extension, utf-8, windows, windows-explorer, windows-shell, windows-shell-extension
- Language: C++
- Homepage:
- Size: 6.25 MB
- Stars: 179
- Watchers: 9
- Forks: 27
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Authors: AUTHORS
Awesome Lists containing this project
README
# ShellAnything #
[](https://opensource.org/licenses/MIT)
[](https://github.com/end2endzone/shellanything/releases)
[](https://github.com/end2endzone/ShellAnything/releases/latest)
[](https://github.com/end2endzone/ShellAnything/releases/latest)
ShellAnything is a C++ open-source software which allow one to easily customize and add new options to *Windows Explorer* context menu. Define specific actions when a user right-click on a file or a directory.
## Status ##
Build:
| Service | Build | Tests |
|----|-------|-------|
| AppVeyor, Visual Studio 2019 | [](https://ci.appveyor.com/project/end2endzone/shellanything) | [](https://ci.appveyor.com/project/end2endzone/shellanything/branch/master/tests) |
| Github Actions, Windows Server 2019 | [](https://github.com/end2endzone/ShellAnything/actions/workflows/build_windows.yml) | [](https://github.com/end2endzone/ShellAnything/actions/workflows/build_windows.yml) |
Statistics:
[](https://ci.appveyor.com/project/end2endzone/shellanything/branch/master)
# Screenshots #
**Files context menu:**
**Directories context menu:**
# Purpose #
Adding new options to Windows Explorer context menu can be done in many ways. One can create new context menus by [manually editing the registry](https://www.groovypost.com/howto/add-any-program-windows-context-menu/) but this option is limited in support (static text, no submenus). If you are technical person, you can also follow [this guide](https://stackoverflow.com/questions/20449316/how-add-context-menu-item-to-windows-explorer-for-folders) on StackOverflow.
With Shell Extension, you can dynamically create a context menu item (or submenu) that is more relevant to the selected file(s).
Shell extension are dynamic by nature because they are runtime DLL inside Windows Explorer. They can show or hide options based on the selected file's name, size, content, etc.
Shell extensions also have the ability to handle multiple selected files simultaneously.
On the downside, writing shell extensions is complicated, tedious and difficult to debug.
This is where ShellAnything is useful. It provides a simple xml-based way of adding new dynamic options to Windows Explorer context menu.
ShellAnything is implemented in C++ which, for writing Shell Extension, is a safe programming language compared to C#. See [Writing Shell Extensions with C#](#writing-shell-extensions-with-c) for details.
## Writing Shell Extensions with C#. ##
Writing Shell Extensions with C# is possible but highly discouraged and probably not a good idea.
Many articles already discussed the subject and they all comes to the same conslusion: ***Don't do it.***
For instance, the following articles are good references:
* StackOverflow have discussed the issue rigorously : [StackOverflow - Windows shell extension with C#](https://stackoverflow.com/questions/2194572/windows-shell-extension-with-c-sharp/2194638#2194638).
* Raymond Chen, from **The Old New Thing**, says "[Do not write in-process shell extensions in managed code](https://devblogs.microsoft.com/oldnewthing/20061218-01/?p=28693)" and following the release of version 4 of the .NET Framework (with in-process side-by-side runtimes), "[the answer is still no](https://devblogs.microsoft.com/oldnewthing/?p=5163)".
* Microsoft [Guidance for Implementing In-Process Extensions](https://docs.microsoft.com/en-us/previous-versions/windows/desktop/legacy/dd758089(v=vs.85)) is discouraging the use of C#.
# Features #
The main features of ShellAnything are:
* Easily add custom menus and submenus.
* Dynamic content based on xml files. Change xml configuration files to see the menu options update automatically.
* Support for custom icons for each menu.
* Support activation and visibility filters based on selected files.
* Define actions executed when a menu option is selected:
* Launch an application.
* Open a document.
* Prompt for a value.
* Change the clipboard.
* and many more.
* Powerful property-based system for rich dynamic content and filters.
* Extendable with a custom plugin system.
* Easily integrate any third party application with custom menus.
* Supports windows [keyboard mnemonics](https://en.wikipedia.org/wiki/Mnemonics_(keyboard)).
**_For more details about ShellAnything features, please refer to the [User Manual](UserManual.md)._**
# Usage #
For instructions on how to use ShellAnything, please refer to the [User Manual](UserManual.md).
The *User Manual* also features *Use Case* with the following examples:
* [Integrate a third party application](UserManual.md#integrate-a-third-party-application).
* [Run an application with parameters](UserManual.md#run-an-application-with-parameters).
* [Open a command prompt in directory](UserManual.md#open-a-command-prompt-in-directory).
* [Select two files for an operation](UserManual.md#select-two-files-for-an-operation).
# Build #
Please refer to file [INSTALL.md](INSTALL.md) for details on how installing/building the application.
# Platform #
ShellAnything has been tested with the following platform:
* Windows 8.1 (32 and 64 bit)
* Windows 10 (32 and 64 bit)
**NOTE:** Version 0.6.1 is the last version of ShellAnything that supports 32-bit Windows.
**NOTE:** Version 0.7 is the last version of ShellAnything that supports Windows 7.
# Versioning #
This project use [Semantic Versioning 2.0.0](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/end2endzone/ShellAnything/tags).
# Authors #
* **Antoine Beauchamp** - *Initial work* - [end2endzone](https://github.com/end2endzone)
See also the list of [contributors](https://github.com/end2endzone/ShellAnything/blob/master/AUTHORS) who participated in this project.
# License #
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details