Skip to content

Commit

Permalink
Publish B-Backup to GitHub
Browse files Browse the repository at this point in the history
  • Loading branch information
An0n-00 authored Nov 20, 2024
1 parent 1876956 commit 8af91fc
Show file tree
Hide file tree
Showing 18 changed files with 2,315 additions and 21 deletions.
716 changes: 716 additions & 0 deletions B-Backup.sh

Large diffs are not rendered by default.

695 changes: 674 additions & 21 deletions LICENSE

Large diffs are not rendered by default.

107 changes: 107 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,107 @@
<div align="center">

# B-Backup 💾

B-Backup is a Bash tool designed to simplify file and directory backups on Linux systems. It offers a range of features including encryption, compression, logging, and more. Despite its CLI nature, it boasts a sleek and user-friendly interface.

[![Project Phase](https://img.shields.io/static/v1?label=Project%20Phase&message=Submitted&color=green)](https://github.com/An0n-00/B-Backup/releases)
[![Maintenance](https://img.shields.io/badge/Maintained%3F-No-red.svg)](https://GitHub.com/an0n-00/B-Backup/graphs/commit-activity)
[![GitHub issues](https://img.shields.io/github/issues/an0n-00/B-Backup.svg)](https://GitHub.com/an0n-00/B-Backup/issues/)
[![GitHub pull-requests](https://img.shields.io/github/issues-pr/an0n-00/B-Backup.svg)](https://GitHub.com/an0n-00/B-Backup/pulls/)
[![GitHub license](https://img.shields.io/github/license/an0n-00/B-Backup.svg)](https://github.com/an0n-00/B-Backup/blob/main/LICENSE)
</div>

## Features

- **Backup**: Easily back up files and directories to a hidden location on your system.

- **Encryption**: Encrypt backups using PKZIP encryption for added security.

- **Compression**: Compress backups using DEFLATE compression to save storage space.

- **Deletion**: Option to delete original files and directories after a successful backup.

- **Restore**: Restore backups to the original location or a custom destination.

- **Export**: Export backups to a custom location for external storage or sharing.

- **Logging**: Record all actions and operations in a log file for future reference.

- **List Backups**: View a list of all backups created by B-Backup.

- **Delete Individual Backups**: Remove specific backups as needed.

- **Search Backup Contents**: Easily search for specific files within any B-Backup created backup.

- **Error Handling**: Gracefully handle errors and provide informative messages to users.

- **Help Menu**: Access a comprehensive help menu for assistance with using B-Backup.

## Getting Started

### Prerequisites

- Linux operating system
- Bash shell
- Sufficient disk space for storing backups

### Installation

1. Clone the B-Backup repository to your local machine:

```bash
git clone https://github.com/An0n-00/B-Backup.git
```

2. Navigate to the B-Backup directory:

```bash
cd B-Backup
```

3. Ensure the script is executable:

```bash
chmod +x b-backup.sh
```

4. Run the script:

```bash
./b-backup.sh
```

5. Follow the on-screen instructions to start using B-Backup.

## Usage

> [!IMPORTANT]
> **B-Backup CANNOT run with root privileges.**
>
> B-Backup prevents the script from running with root privileges, which could potentially cause harm to the system and cause unwanted side effects while using the script. If the script is run with root privileges, the script will exit with an error message. Therefore, **please run the script as a regular user.**

1. Run the script to launch the interactive menu:

```bash
./b-backup.sh
```

2. Follow the on-screen prompts to perform backup, restoration, or other operations.

## Screenshots

| The Startup animation if you run the script | The nice and intuitive backup management menu |
|---------------------------------------------|-----------------------------------------------|
| ![Startup Image](/docs/images/startup.png) | ![Backup management menu](/docs/images/manage-menu.png) |

## Contributing

Contributions to B-Backup are welcome! If you have suggestions, feature requests, or would like to report issues, please open an issue or submit a pull request on GitHub.

### Contibutors

[![Contributors](https://contrib.rocks/image?repo=an0n-00/B-Backup)](https://github.com/an0n-00/B-Backup/graphs/contributors)

## License

This project is licensed under the [GNU General Public License v3.0](https://github.com/an0n-00/B-Backup/blob/main/LICENSE).
1 change: 1 addition & 0 deletions Struktogramm.json

Large diffs are not rendered by default.

1 change: 1 addition & 0 deletions docs/HelpTOC.json
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
{"entities":{"pages":{"Documentation":{"id":"Documentation","title":"B-Backup","url":"documentation.html","level":0,"tabIndex":0},"Script":{"id":"Script","title":"Script","url":"script.html","level":0,"tabIndex":1}}},"topLevelIds":["Documentation","Script"]}
1 change: 1 addition & 0 deletions docs/Map.jhm
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
<?xml version='1.0' encoding='UTF-8'?><map version="2.0"><mapID target="Script" url="script.html" default="no"/><mapID target="Documentation.md" url="documentation.html" default="yes"/><mapID target="B-Backup" url="documentation.html" default="no"/><mapID target="Documentation" url="documentation.html" default="yes"/><mapID target="Script.md" url="script.html" default="no"/></map>
1 change: 1 addition & 0 deletions docs/api-object-digest.json
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
{}
1 change: 1 addition & 0 deletions docs/config.json
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
{"productVersion":"1.0.1.0","productWebUrl":".","productId":"B-Backup","stage":"release","downloadTitle":"Get B-Backup","keymaps":{},"searchMaxHits":75,"productName":"B-Backup"}
1 change: 1 addition & 0 deletions docs/current.help.version
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
1.0.1.0
79 changes: 79 additions & 0 deletions docs/documentation.html

Large diffs are not rendered by default.

Binary file added docs/images/M122.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/Struktog.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/m122preview.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/manage-menu.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/menu-new.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/startup.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
9 changes: 9 additions & 0 deletions docs/index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
<!DOCTYPE html>
<html lang="en-US">
<meta charset="utf-8">
<title>You will be redirected shortly</title>
<meta http-equiv="refresh" content="0; url=documentation.html">
<h1>Redirecting&hellip;</h1>
<a href="documentation.html">Click here if you are not redirected.</a>
<script>location = "documentation.html"</script>
</html>
Loading

0 comments on commit 8af91fc

Please sign in to comment.