Metadata-Version: 2.1
Name: USB-Imager
Version: 1.0
Summary: GUI-Application to write bootable disk images to USB key.
Home-page: https://gitlab.com/skynet-devel/usb-imager
Author: skynet-devel
Author-email: skynet-devel@mailbox.org
License: GPLv3
Project-URL: Source, https://gitlab.com/skynet-devel/usb-imager
Keywords: usb,image,iso,write
Platform: linux
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: System Administrators
Classifier: Topic :: System
Classifier: Topic :: Utilities
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.5
Classifier: Environment :: X11 Applications :: Qt
Classifier: Natural Language :: English
Requires-Python: >=3.5
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Requires-Dist: importlib-resources
Requires-Dist: PyGObject
Requires-Dist: PySide2

# USB-Imager

[USB-Imager] is a GUI tool to write bootable disk images to USB key.

|[License]   | GPLv3
|--------    | --------
|*Copyright* | **&copy; 2021 by Skynet-Research**
- - - - - - -

![Screenshot]


## 1. Features

- [x] No root privileges required.
- [x] Drives get unmounted and locked (if encrypted) before writing.
- [ ] Automatic deactivation of LVM2 volumes before writing
- [x] Writing support for hybrid ISOs by checking the MBR signature.
- [x] Adjustable write buffer -> 1-16 MiB
- [ ] Checksum verification after copying
- [ ] Multilanguage support


## 2. Requirements

***System:***  
Python >=3.5, pip, Qt >5, UDisks2

- _Debian based linux:_

    For \*ubuntu open `Software & Updates` and activate the `universe` repository or activate it via terminal.

    + Ubuntu, Kubuntu, Xubuntu:

        ```bash
        $ sudo add-apt-repository universe && sudo apt update
        $ sudo apt install qt5-default gir1.2-udisks-2.0 python3-pip
        ```

- _Red Hat based linux:_

    + Fedora -> Gnome:

        ```bash
        $ sudo dnf install python3-pyside2
        ```

- _Slackware based linux:_

    + openSUSE 15.2 "Leap" -> Gnome:

        ```bash
        $ sudo zypper install python3-pyside2 typelib-1_0-UDisks-2_0
        ```


## 3. Installation

USB-Imager can be easily installed/uninstalled using `pip`.

Please try to install USB-Imager without **`sudo`** but sometimes it necessary to do a system-wide installation, because in many distributions the search path `$PATH` is not configured correctly to find the startup program.

```bash
$ pip3 install -U usb-imager
$ pip3 uninstall usb-imager
```

or [pipenv]:

```bash
$ pipenv install usb-imager
$ pipenv run usb-imager
$ pipenv uninstall usb-imager
```


## 4. Usage

Start USB-Imager via the desktop icon or just type `usb-imager` in your terminal window.


## 5. Tested linux distributions

- _Arch based:_
    + Manjaro 20.2.1 "Nibia" -> `KDE`, `Xfce`, `Gnome`

- _Debian based:_
    + Ubuntu "Bionic Beaver", "Focal Fossa" -> `Kylin`, `Kubuntu`, `Xubuntu`

- _Red Hat based:_
    + Fedora 33 -> `Workstation`

- _Slackware based:_
    + openSUSE 15.2 "Leap" -> `Gnome`


## 6. Support

If you want to report a bug or request a feature, you can do so [here].
You can also write an email to <skynet-devel@mailbox.org>.


## 7. Acknowledgements

Thanks to:

- the programmers at [SUSE Linux Products GmbH] for their [SUSE Studio Imagewriter].
It was the inspiration for this little tool.
- Rico for Beta-Testing.
- my loved ones for their almost infinite patience.



[USB-Imager]: https://pypi.org/project/usb-imager/
[License]: https://www.gnu.org/licenses/gpl-3.0-standalone.html
[Screenshot]: https://gitlab.com/skynet-devel/usb-imager/-/raw/master/Screenshot.webp

[pipenv]: https://pypi.org/project/pipenv/
[here]: https://gitlab.com/skynet-devel/usb-imager/issues

[SUSE Linux Products GmbH]: https://www.suse.com/
[SUSE Studio Imagewriter]: https://github.com/openSUSE/imagewriter

- - - - - - - - - -

# Changelog:

#### Version 1.0.0
- Initial version


