TranslucentFlyoutsConfig
A configuration GUI for Translucent Flyouts
Install / Use
/learn @Satanarious/TranslucentFlyoutsConfigREADME
Translucent Flyouts Config GUI is a companion application for Translucent Flyouts¹ for Windows 10/11, which allows various customizations for windows32 style context menus.
Other Languages
Catalog:
- Installation Instructions
- Usage Instructions
- Contribution
- Planned Features
- Dependencies
- Disclaimer
- License
[!Important] If the latest version of Translucent Flyouts¹ doesn't work well or doesn't work at all with the latest version of Translucent Flyouts Config, make sure to create an issue or discussion and talk about it there. Both Translucent Flyouts¹ and Translucent Flyouts Config are developed under a FOSS license, and any incompatibility might be due to communication gap and difference in time zones between the two developers, and the fact that this software is dependent on Translucent Flyouts¹ and not the other way around. Rest assured, I strive to make this software compatible with the latest version of Translucent Flyouts as soon as possible if that is ever not the case for future releases.
Installation Instructions
1. 1-Click Install (★ Recommended)
[!Warning] For old Translucent Flyouts¹ users, uninstall the manually installed version of Translucent Flyouts¹ and then follow the underlying steps. <img src="Screenshots/all_tabs_spread.png" align="right" width=500>
- Download the latest release
- Extract all files in a directory/folder.
- Run the
TranslucentFlyoutsConfig.exefile. - Go to Settings.
- Under External Functions, click the
Download and Installbutton
2. Manual Install
Assuming you have the latest release of Translucent Flyouts¹ Installed.
- Download the latest release
- Extract all files in a directory/folder.
- Run the
TranslucentFlyoutsConfig.exefile. - Go to Settings.
- Under General settings, set the path to the installation location of Translucent Flyouts.
Usage Instructions
- Left-clicking on the <img src="Assets/icons/light/reset_icon.png" width=13> reset button on the far right of any setting resets the value to its default value.
- Right-clicking on the <img src="Assets/icons/light/reset_icon.png" width=13> reset button on the far right of any setting resets the value to its last-saved value.
- Use the <img src="Assets/icons/light/color_picker_icon.png" width=15> color-picker to choose the color including the alpha(Opacity) value.
- Left-clicking the
Reset Allbutton on each page resets all parameters to default. - Right-clicking the
Reset Allbutton on each page resets all parameters to their last values. - Use the
Disabled Listbutton for each category to add/remove processes and disable/enable Translucent Flyouts' features for a particular process for that category. - See the avaiable values and their descriptions by click on any parameter label.
- Any changes are immediately applied on pressing the
ApplyorSavebutton in the respective section. - In the Settings section:
- Change the app-language in the
General Sectionby selecting the language. - Change the theme of the application in the
Appearance Sectionby selection colors for respective items/backgrounds and more. You can also select from a list of predefined theme presets available just below the color selection. - Access functions such as Run, Stop, Install and Uninstall in the
Internal Functionssection. - Download and Install Translucent Flyouts with one click of a button present in the
External Functionssection. - For Advanced User, use the
Advanced Functionssection to access the Block List and configure it.
- Change the app-language in the
Contribution
Translation
You can contribute to the language of your choice that you are confident in contributing to for this project. You may wanna look at this translation file before proceeding to contribute.
For first time contributors use the following Steps:
- Fork the Repository.
- Create a file in the Translations directory using the name convention
LanguageCode-CountryCode.json, all in lowercase. - Copy everything from hi-in.json and paste it into you new file.
- Remove Hindi translations for each corresponding English ones and replace with translation for your respective language.
[!Important] There's a translations where a line ends with
<code>and another that starts with</code>, pay close attention and keep it that way in you translation as well, else it will break the code. Here are the lines:
"Uses the corresponding value in the global tab as the <code>""</code> value."
If you wanna go a few steps further and edit python, you might as well follow these:
- Open Data/enum.py and add an additional value to the class
Languages. - Open Data/paths.py and under class
Translationsadd the path to you translation path in the exact way as mentioned there for the previously mentioned language(s). - Open Data/translations.py and under class
TranslationModel, under method_fetch(), find a dictionarytranslationPathand add another pair in the formatLanguageEnum:LanguageJSONPathVariable - Open main.py and under method
__init__you will find a line which saysself.languagewith a list of language names in their own languages. Add one for the one you are adding.
[!Note] If you just wanna do the first part, I'll accept PR for the same as well and do the 2nd part myself. But the 2nd part would be appreciated.
Bug Fixes and Improvements
- Bug Fixes: If you find a bug, please create a pull request with a clear description of the issue and how to fix it.
- Improvements: Have an idea on how to improve Translucent Flyouts Config? Please create an issue first to discuss why the improvement is needed.
For more information, see the contribution guide.
Planned Features
Checkout the tracker for more details on this. <img src="Screenshots/theme_tease.png" align=right width=50%>
- [x] Translation Support.
- [x] Better Parameter Explanations.
- [x] In-App Themeing Support.
- [x] Translucent Flyouts Internal Function support:
- [x] Restart
- [x] Stop
- [x] Install
- [x] Uninstall
- [x] Download Latest Version of Translucent Flyouts.
- [
