Skip to content

Commit ab26491

Browse files
authored
Create README.md
1 parent 7deafd8 commit ab26491

File tree

1 file changed

+46
-0
lines changed

1 file changed

+46
-0
lines changed

README.md

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
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

Comments
 (0)