TinyWall

A free, lightweight and non-intrusive firewall
Website »

About this repository

This is the source code of TinyWall as found at its website. Upstream development is now largely inactive, but this repository is provided for anyone who would like to submit their own improvements or fork the project.

How to build

Necessary tools

• Microsoft Visual Studio 2019 (v16.11.xx)
  (VS 2022 should also work but not tested)
• Wix v3 Toolset
• Visual Studio extension for Wix v3 Toolset

To build the application

1. Open the solution file in Visual Studio and compile the TinyWall project. The other projects referenced inside the solution need not be compiled separately as they will be statically compiled into the application.
2. Done.

To update/build build the database of known applications

1. Adjust the individual JSON files in the TinyWall\Database folder.
2. Start the application with the /develtool flag.
3. Use the Database creator tab to create one combined database file in JSON format. The output file will be called profiles.json.
4. To use the new database in debug builds, copy the output file to the TinyWall\bin\Debug folder.
5. Done.

To build the installer

1. Copy the compiled application files and all dependencies into the MsiSetup\Sources\ProgramFiles\TinyWall folder.
2. Update the files as necessary inside the MsiSetup\Sources\CommonAppData\TinyWall folder. See instructions above about creating the database.
3. Open the solution file in Visual Studio and compile the MsiSetup project.
4. Done.

Contributing

Please don't open issues for feature requests or bug reports. Any changes you'd like you will need to implement yourself. If you have improvements that you would like to integrate into TinyWall, please fork the repo and create a pull request.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

For complex features or large changes, please contact me first if your changes are still within the scope of the application.

If you prefer that, you can also build and distribute your own version of the binaries. In this case though you need to choose a different name other than TinyWall for your application.

License

• TaskDialog wrapper (code in directory pylorak.Windows\TaskDialog) written by KevinGre (link) and placed under Public Domain.

• All other code in the repository is under the GNU GPLv3 License. See LICENSE.txt for more information.

Contact

Károly Pados - find e-mail at the bottom of the project website

Website: https://tinywall.pados.hu

GitHub: https://github.com/pylorak/tinywall