AddIns

docs/AddIns/Community/AutoSave.md

@@ -0,0 +1,49 @@
+---
+title: Auto Save
+parent: Community Add Ins
+# nav_order: 
+permalink: /tB/IDE/AddIns/Community/AutoSave
+---
+
+## Auto Save
+
+AutoSave addin for twinBasic, provides automatic saving with the ability to choose a time interval, confirmation and Auto-load.
+
+> Latest Release: [v3.1.5.0](https://github.com/sokinkeso/AutoSaveAddin/releases/tag/v3.1.5.0)
+
+Developer: @sokinkeso (Community)
+
+![Auto Save](Images/AutoSave.png "Auto Save")
+
+### Features
+
+- Automatic saving
+- Choose a time interval
+- Choose interval type (seconds or minutes)
+- Check project for changes before saving
+- Shows notification for the First-time-save, in a new project
+- Confirmation before save
+- Auto-Load on project open/new
+- Startup options: Start Enabled, Disabled or  Ask the user
+- Logging in the debug console
+- Keeps General or Project settings
+- Save before Project run
+
+The button, that added on the toolbar, has two functions:
+
+- Enable/Disable the Autosave functionality (with Click)
+- Show addin settings (with Double-click)
+
+
+> [!IMPORTANT]  
+> **To install this addin in TwinBasic, just unzip and copy each architecture dll in the corresponding folder**  
+> `\twinBASIC_IDE_BETA_xxx\addins\win32\`  
+> `\twinBASIC_IDE_BETA_xxx\addins\win64\`  
+
+## Download
+
+- https://github.com/sokinkeso/AutoSaveAddin/releases
+
+## Links
+
+- https://github.com/sokinkeso/AutoSaveAddin

docs/AddIns/Community/Comments.md

@@ -0,0 +1,48 @@
+---
+title: Comments
+parent: Community Add Ins
+# nav_order: 
+permalink: /tB/IDE/AddIns/Community/Comments
+---
+
+## Comments
+
+This is an Add-in that takes advantage of TwinBasic's ability to insert inline and multiline comments.
+
+The addin, appears on the IDE with two new buttons (Comment and Uncomment).
+
+> Latest Release: N/A https://github.com/sokinkeso/Comments-Addin-for-twinBasic/releases
+
+Developer: @sokinkeso (Community)
+
+![Comments](Images/Comments.png "Comments")
+
+### Features
+
+- Line-Mode commenting
+This mode works with selecting a number of lines or a single line or just putting the cursor on a line.
+Clicking the [Comment] button, will comment-out each line separately.
+
+- Range-Mode commenting
+Select multiple lines or a range of characters in a line and with CTRL+Click on the [Comment] button,
+a single comment will be created for the whole range.
+
+- Uncomment
+Put the cursor inside the range of a comment, and click the [Uncomment] button.
+
+- Empty lines not commented-out
+
+- Line continuation character (_) , is not included inside the comment (Line-Mode)
+
+> [!IMPORTANT]  
+> **To install this addin in TwinBasic, just unzip and copy each architecture dll in the corresponding folder**
+> \twinBASIC_IDE_BETA_xxx\addins\win32\
+> \twinBASIC_IDE_BETA_xxx\addins\win64\
+
+## Download
+
+- https://github.com/sokinkeso/Comments-Addin-for-twinBasic/releases
+
+## Links
+
+- https://github.com/sokinkeso/Comments-Addin-for-twinBasic

docs/AddIns/Community/CopyPasteEx.md

@@ -0,0 +1,57 @@
+---
+title: Copy Paste Ex
+parent: Community Add Ins
+# nav_order: 
+permalink: /tB/IDE/AddIns/Community/CopyPasteEx
+---
+
+## Copy Paste Ex
+
+The CopyPasteEx add-in enhances file management within twinBASIC by introducing a seamless copy/paste capability for Project Explorer Files across multiple twinBASIC instances. 
+By leveraging the system clipboard, this add-in enables efficient file transfers, 
+ensuring a smooth workflow for developers working on multiple projects.
+
+> Latest Release: [v0.9.4](https://github.com/sokinkeso/CopyPasteEx-Addin-for-twinBASIC/releases/tag/v0.9.4)
+
+Developer: @sokinkeso (Community)
+
+![CopyPasteEx](Images/CopyPasteEx.png "CopyPasteEx")
+
+### Features
+
+1) Uses system clipboard to enable copy/paste functionality for files between twinBASIC instances.
+
+2) Copying files via the [Copy (Project Explorer Files)] button:
+  - Copies selected files to the clipboard in a custom binary clipboard format.
+  - Allows selecting multiple files using Ctrl or Shift keys.
+
+3) Pasting files via the [Paste (Project Explorer Files)] button:
+   - Pastes copied files into a selected folder or the parent folder of the selected item.
+   - If a file already exists in the destination, a dialog prompts the user to decide whether to overwrite or not.
+
+4) Exclusions from copying:
+   - Folders
+   - Hidden items
+   - Items inside special folder's path (except Sources and Resources)
+     e.g.
+
+          \Packages\VB\CHANGELOG.md   		cannot be copied
+
+          \References\stdole          		cannot be copied
+
+          \Sources\Form1.twin         		can be copied
+
+          \Resources\ICON\twinBASIC.ico	   	can be copied
+
+> [!IMPORTANT]  
+> **To install this addin in TwinBasic, just unzip and copy each architecture dll in the corresponding folder**
+> \twinBASIC_IDE_BETA_xxx\addins\win32\
+> \twinBASIC_IDE_BETA_xxx\addins\win64\
+
+## Download
+
+- http://github.com/sokinkeso/CopyPasteEx-Addin-for-twinBASIC/releases
+
+## Links
+
+- https://github.com/sokinkeso/CopyPasteEx-Addin-for-twinBASIC

docs/AddIns/Community/ExternalTools.md

@@ -0,0 +1,74 @@
+---
+title: External Tools
+parent: Community Add Ins
+# nav_order: 
+permalink: /tB/IDE/AddIns/Community/ExternalTools
+---
+
+## External Tools
+
+With this addin, you can call any of your favorite tools from inside the twinBasic IDE, like: Hex editors, debuggers, console window, zip/unzip tools, calculators, versioning control tools, and many other!
+
+> Latest Release: [v1.2.0.0](https://github.com/sokinkeso/ExternalTools-Addin-for-twinBasic/releases/tag/v1.2.0.0)
+
+Developer: @sokinkeso (Community)
+
+![ExternalTools](Images/ExternalTools.png "ExternalTools")
+
+### Features
+
+1) A floating panel window for showing the available tools. To show this window you have to click on the "Exteranl Tool button" on the IDE toolbar.
+in this window you have a list of the tools and a Configuration button at the top.
+You can execute any tool from the list with a single click.
+This window can be moved or docked in the IDE. For saving its docked position use the "Window->Panel Layouts->Save Current Panel layout as"
+menu from the IDE menus.
+
+1) Settings window. With a single click on the Configuration button, the Settings window appears. 
+In this window you can see an other list with the available tools. 
+This time, clicking on the list, the details of each tool are shown in the fields below the list.
+
+1) You have six buttons available for manipulating your tools: 
+ - New, for creating a new tool 
+ - Edit, for editing an existing tool 
+ - Save, for saving the current editing (new or existing)
+ - Cancel, for cancel the edit state 
+ - Douplicate, for creating a new tool based on the selected one
+ - Delete, for deleting the selected tools
+
+2) You also have four buttons at the right side of the window to change the order in which the tools appear.
+
+3) Right clicking on the list, you have a popup menu with the basic actions (New, Edit, Duplicate), and
+   two extra actions:
+- Copy, for copying the selected tools as a TAB delimited list in the clipboard
+- Paste, for pasting a list of tools from the clipboard in the list.
+You can use Copy/Paste for quick importing the examples provided with the addin.
+
+When adding or editing a tool, have in mind that:
+ - the "Name" and "Application Path" are required fields. You cannot save the tool without these two fields.
+ - You can select the desired app clicking on the ellipsis button at the right of the textbox, or you just can write the name of the executable.
+ - In the "Parameters" field, you can add any command line parameters for the tool.
+ - The "Working dir" field, is for setting the default directory. Not all applications respect this.
+ - The "Run As Admin" check box is for running your tool with administrative rights.
+ - The "Visible" checkbox is used to show the tool in the main addin list.
+ - The "Confirm before run" checkbox is used to ask for confirmation before running the tool.
+ - Clicking the [*] button, you have the ability to choose from a list of predefined variables , like time, date, project name and so on.
+ - Clicking on the [>]] button, you can preview the real parameters.
+ - Clicking on the Save button above the list, only saves temporary the changes to the list.
+   You have to click the [Update] button , so any changes will be made permanent, and available next time the addin loads.
+
+** The "Other Settings" tab is disabled in this release **
+
+> [!IMPORTANT]  
+> **To install this addin in TwinBasic, just unzip and copy each architecture dll in the corresponding folder**
+> \twinBASIC_IDE_BETA_xxx\addins\win32\
+> \twinBASIC_IDE_BETA_xxx\addins\win64\
+
+Any comments/suggestions/bug reports,  are always welcome!
+
+## Download
+
+- https://github.com/sokinkeso/ExternalTools-Addin-for-twinBasic/releases
+
+## Links
+
+- https://github.com/sokinkeso/ExternalTools-Addin-for-twinBasic

docs/AddIns/Community/MsgBox-Builder.md

@@ -0,0 +1,65 @@
+---
+title: MsgBox Builder
+parent: Community Add Ins
+# nav_order: 
+permalink: /tB/IDE/AddIns/Community/MsgBoxBuilder
+---
+
+## MsgBox Builder
+
+MsgBox Builder addin, is designed to provide a user-friendly GUI for creating built-in message boxes, along with accompanying code to handle user responses.
+By automating the creation of the MsgBox statement, the time of writing the code by hand is significantly reduced.
+
+> Latest Release: [v1.1.6](https://github.com/sokinkeso/MsgBox-Builder-Addin-for-twinBasic/releases/tag/v1.1.6)
+
+Developer: @sokinkeso (Community)
+
+![MsgBoxBuilder](Images/MsgBoxBuilder.png "MsgBoxBuilder")
+
+### Features
+
+- Application or Custom title, with the option of using separate variable
+- Message ,with the option of using separate variable
+- Easy icon selection
+- Easy Button-Group and Default Button selection
+- Return value check using Select-Case or If-ElseIf statements, with the option of using separate variable.
+- Copy to Clipboard button
+- Preview button
+
+> [!IMPORTANT]  
+> **To install this addin in TwinBasic, just unzip and copy each architecture dll in the corresponding folder**
+> \twinBASIC_IDE_BETA_xxx\addins\win32\
+> \twinBASIC_IDE_BETA_xxx\addins\win64\
+
+<details>
+<summary>Release History</summary>
+
+2024-03-28
+----------
+- MsgBox Builder addin designed and implemented
+
+2024-03-29
+----------
+- Fixed Custom title automatically selected, once typing has started in the custom title textbox (Wayne Philips)
+- Fixed Issue when empty string was specified as a message.
+- Added Preview button
+
+2024-04-01
+----------
+- Fixed x64 bug, addin window not owned by the IDE
+
+2025-04-24 v1.1.6 ***build with BETA 747
+------------------
+- fixed: buttons selection not aligned with Select-Case and If-Then statements
+- minor graphical issues
+- light theme added
+
+</details>
+
+## Download
+
+- https://github.com/sokinkeso/MsgBox-Builder-Addin-for-twinBasic/releases
+
+## Links
+
+- https://github.com/sokinkeso/MsgBox-Builder-Addin-for-twinBasic

docs/AddIns/Community/StringConverter.md

@@ -0,0 +1,47 @@
+---
+title: String Converter
+parent: Community Add Ins
+# nav_order: 
+permalink: /tB/IDE/AddIns/Community/StringConverter
+---
+
+## String Converter
+
+String converter addin is designed to hide your strings inside the compiled .exe, to prevent someone from changing them with a hex editor.
+This addin, parses your source code and finds all strings occurances, avoiding the ones inside comments (single or multi line), Dll Declares and Attributes.
+Then it can subtitute the strings with constructed strings using the `ChrW$()` function.
+This way the strings are "invisible" if you try to search them with a hex editor.
+String converter can also do the reverse job, i.e. convert the multiple uses of Chr() function, back to normal string.
+You can use the immediate convertion if you want to check normal or converted text.
+
+This project essentially consists of three separate projects, which were combined to create the final addin.
+- The Parser, gaves me the opportunity to work on parsing techniques, and use them from inside TwinBasic.
+- The xTabbedControl, a usercontrol that hoppefuly will replace the MS Tabbed control.
+- The custom Msgbox (MsgForm), a themed message dialog.
+
+> Latest Release: [v2.2.0.0](https://github.com/sokinkeso/String-Converter-Addin-for-twinBasic/releases/tag/v2.2.0.0)
+
+Developer: @sokinkeso (Community)
+
+![StringConverter](Images/StringConverter.png "StringConverter")
+
+### Features
+
+- Search for normal strings in twinBasic code editor
+- Search for "hidden" strings with chrw$ function
+- Minimum string length
+- Immediate Text to ChrW$ conversion
+- Immediate ChrW$ to text conversion
+
+> [!IMPORTANT]  
+> **To install this addin in TwinBasic, just unzip and copy each architecture dll in the corresponding folder**
+> \twinBASIC_IDE_BETA_xxx\addins\win32\
+> \twinBASIC_IDE_BETA_xxx\addins\win64\
+
+## Download
+
+- https://github.com/sokinkeso/String-Converter-Addin-for-twinBasic/releases
+
+## Links
+
+- https://github.com/sokinkeso/String-Converter-Addin-for-twinBasic