> For the complete documentation index, see [llms.txt](https://hypersanity.gitbook.io/hs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hypersanity.gitbook.io/hs/player-tools/wip-playertool3/onecommander/scripting.md).

# Scripting

<details>

<summary>Basic</summary>

## Basics of Scripting

OneCommander’s scripting capabilities empower users to automate tasks, saving time and streamlining workflows. Whether you’re new to scripting or an experienced user, here’s how you can start:

***

**1. What is Scripting in OneCommander?**

* Scripting allows you to create commands or automate repetitive tasks within OneCommander.
* Common tasks include:
  * Renaming files in bulk.
  * Organizing files into specific folders based on criteria.
  * Automating file backups or deletions.

***

**2. Where to Access Scripting Tools**

* **Pro Mode**: Scripting is available exclusively in Pro mode, ensuring access to advanced automation features.
* Navigate to the **Scripting Menu** within the settings or toolbar to start creating scripts.

***

**3. Simple Example: Renaming Files**

Here’s how you can create a script to rename multiple files in a directory:

* Go to the **Scripting Menu** and select "New Script."
* Define the operation (e.g., add a prefix, replace text in file names).
* Test the script on a small batch of files to ensure accuracy.

***

**4. Script Editor Overview**

* **Script Area**: Write and edit your script code.
* **Preview Pane**: Test your script in real-time to see changes without applying them.
* **Run Options**: Choose whether to apply the script to selected files, an entire folder, or specific file types.

***

**5. Getting Started**

* Begin with prebuilt script templates available in OneCommander to learn basic syntax and functionality.
* Modify templates to fit your needs or write scripts from scratch as you gain confidence.

***

**Pro Tip**: Start small! Focus on automating a simple task and build up to more complex workflows as you get comfortable with scripting.

</details>
