Skip to content

Commit 4e1d176

Browse files
authored
Create README.md
1 parent 1722947 commit 4e1d176

1 file changed

Lines changed: 55 additions & 0 deletions

File tree

README.md

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
# b2clone
2+
3+
A simple CLI tool to push local folders and files to Backblaze B2 cloud.
4+
5+
## Why create b2clone?
6+
7+
This is my initiative to create my own Backblaze B2 client instead of using third party / open source tools. I used rclone before, which is impressively good but I accidently deleted my B2 script. Instead of creating another script, I create my own tool to push my data to B2 cloud which I can customize whatever I want it to be. 😁
8+
9+
## Disclaimer
10+
11+
*Use at your own risk. I'm not responsible if anything happens to your local files, B2 files, your cat, your mother, etc.*
12+
13+
## Screenshot
14+
15+
![Screenshot of b2clone](https://f001.backblazeb2.com/file/public-cloud/Pictures/Github/b2clone/Screenshot+2020-10-18+213809.png)
16+
17+
![User configuration](https://f001.backblazeb2.com/file/public-cloud/Pictures/Github/b2clone/Screenshot+2020-10-18+213908.png)
18+
19+
## Features
20+
21+
* It should be fast 🤣
22+
* Supposedly works on other OSes, but I only tested on my Windows machine
23+
* Using [xxHash](https://github.com/Cyan4973/xxHash) for file hashing
24+
25+
## To-do
26+
27+
* Add support for local file removal detection, and put those file in your bucket trash bin.
28+
* Make the journal (embedded database) file size smaller.
29+
* Files encryption
30+
* Graphical user interface (GUI) - This is my original idea, but it does take a lot of time to do this. So I just make CLI tool first. 😔
31+
32+
## How to use
33+
34+
1. Run b2clone (to generate the user configuration file = *user.conf.txt*)
35+
2. Edit the configuration file as required.
36+
* *PathMapper* maps your bucket path to your local path. Left side is your bucket path, right side is your local path.
37+
* Remember `\\` for your local path.
38+
3. Save your configuration file and run b2clone again.
39+
40+
## How to build
41+
42+
### Windows
43+
44+
1. You should have dotnet core 3.x
45+
2. Clone this repo or download this as zip - Your choice
46+
3. Go to `b2clone\b2clone`
47+
4. Type `dotnet build --configuration Release`
48+
5. Compiled files will be generated at `bin\Release`.
49+
50+
### Linux/MacOs
51+
52+
* Should be same like Windows but **I do not test or run this tool all on these OSes**. It might be broken.
53+
54+
---
55+
b2clone - Ijat.my

0 commit comments

Comments
 (0)