|
| 1 | +<p align="center"> |
| 2 | + <img width="500px" src="https://github.com/PyBotDevs/isobot-resources/blob/base/lazer/icons/grey-transparent.png?raw=true"> |
| 3 | +</p> |
| 4 | + |
| 5 | +<h1 align='center'>Isobot Data Migration Assistant</h1> |
| 6 | + |
| 7 | +### ***Make sure to check out the Main Repository: [isobot](https://github.com/PyBotDevs/isobot)*** |
| 8 | + |
| 9 | +The Isobot Data Migration Assistant is a lightweight setup tool developed for the isobot client, that's quick and easy to use. |
| 10 | + |
| 11 | +This tool was created after a major update was made to the Isobot Project, where the location of the database, logs and configuration directories in the bot, were moved from the main bot folder to a separate data folder in the user's home directory on their computer. |
| 12 | + |
| 13 | +## What exactly does this do? |
| 14 | +Since this Isobot update, all of the existing database, logs and config directories are now considered as **legacy directories**. This tool helps migrate all of the existing data from the legacy directories to the new folders located at the user's home directory. |
| 15 | + |
| 16 | +***NOTE:*** The new directory location will be at: |
| 17 | +- For Windows: `C:\Users\{your username}\.isobot\` |
| 18 | +- For Linux/macOS: `/home/{your username}/.isobot/` |
| 19 | + |
| 20 | +It copies all of the existing databases, logs and config files from the legacy directories into the new data directory |
| 21 | + |
| 22 | +## How do I use this tool? |
| 23 | +This is a very simple tool to use, as shown in the following steps: |
| 24 | +1. Make sure that your Isobot installation is completely up to date. (any version after version `v2024.1225.0`) |
| 25 | +2. Clone the migration assistant repository into a **separate folder** on your computer by running the following command: |
| 26 | + |
| 27 | + ``` |
| 28 | + git clone https://github.com/pybotdevs/isobot-data-migration-assistant.git |
| 29 | + ``` |
| 30 | +3. Copy the `isobot-data-migration-assistant.py` file from the repository to the isobot directory, and enter isobot's working directory by running this command in command prompt: |
| 31 | + |
| 32 | + ``` |
| 33 | + cd /path/to/isobot |
| 34 | + ``` |
| 35 | +4. Run the python file with the following command: |
| 36 | + |
| 37 | + ``` |
| 38 | + python isobot-data-migration-assistant.py |
| 39 | + ``` |
| 40 | +5. Watch the tool do its magic, and you shall be informed when the migration process is finished. |
| 41 | + |
| 42 | +## Troubleshooting |
| 43 | +### I can't find the new folder! (Linux/macOS) |
| 44 | +Since the folder is named as `.isobot`, the `.` before the folder name automatically marks this folder as a *hidden folder* in the filesystem. |
| 45 | + |
| 46 | +If you are on **Windows**, you need not worry as this does not apply to your folder. |
0 commit comments