Skip to content

Commit

Permalink
Update README.me
Browse files Browse the repository at this point in the history
  • Loading branch information
tfuxu committed Jun 25, 2022
1 parent 96a4fff commit 94fa942
Showing 1 changed file with 39 additions and 19 deletions.
58 changes: 39 additions & 19 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,52 +1,72 @@
# Win32 Details
![License](https://img.shields.io/github/license/tfuxu/win32-details)

> .exe file details for your Nautilus file browser
**Win32 Details** is an additional page in Properties dialog named `Details`, similar to that from Windows File Explorer. It allows to conveniently display a specific details about .exe files within comfort of your file browser.

![win32-details v0.1](https://raw.githubusercontent.com/tfuxu/win32-details/main/data/images/win32-details-screenshot-1.png)

## How to use it
Just right-click on any .exe file, go to Properties, and click `Details` tab.
Just right-click any .exe file, go to Properties, and click `Details` tab.

## Installation
### Requirements
* Probably could be even a **Nautilus 2.32.x**, but I'm not sure, you can test that if you want :)
* Copy of [exiftool](https://github.com/exiftool/exiftool) installed globally on system
* [nautilus-python](https://wiki.gnome.org/Projects/NautilusPython)
* **Python** >= 3.6,
* Probably a recent version of **Nautilus 3.x**, or **Nautilus 4x**,
* [nautilus-python](https://wiki.gnome.org/Projects/NautilusPython),
* Copy of [exiftool](https://github.com/exiftool/exiftool) (required by PyExifTool),
* [PyExifTool](https://pypi.org/project/PyExifTool/)

### From source
**[NOTE]** This is the only option, because I didn't submitted this extension to PyPI or AUR yet, so there isn't any 'easy' approach for now.
### From PyPI
Win32 Details can be installed system-widely or just for the current user.

**1.** Clone the repository, and cd to it:
User install:
```
git clone https://github.com/tfuxu/win32-details.git
cd win32-details
pip3 install --user win32-details
win32-details --install-user
```

System-wide install:
```
sudo pip3 install win32-details
sudo win32-details --install-system
```

**2.** Install Python requirements:
Close currently opened Nautilus instances to load the extension:
```
pip install -r requirements.txt
nautilus -q
```

### From source
Clone the repository, and cd to it:
```
git clone https://github.com/tfuxu/win32-details.git
cd win32-details
```

**3.** Now you need to copy `win32-details.py` file to one of those locations:
Win32 Details can be installed system-widely or just for the current user.

`~/.local/share/nautilus-python/extensions/` - User install:
User install:
```
cp win32-details.py ~/.local/share/nautilus-python/extensions/win32-details.py
pip3 install --user .
win32-details --install-user
```

`/usr/share/nautilus-python/extensions/` - System-wide install:
System-wide install:
```
sudo cp win32-details.py /usr/share/nautilus-python/extensions/win32-details.py
sudo pip3 install .
sudo win32-details --install-system
```

**4.** Close current Nautilus instances to load extension:
Close currently opened Nautilus instances to load the extension:
```
nautilus -q
```

## Changelog
* **0.4:**
* Add a `MD5 Hash` row
* Allow user to copy values from rows (if row is selected, click left one time to select text)
* Add setup.py for packaging to PyPI
* Create a small CLI tool for easier installing (based on [Nautilus Terminal](https://github.com/flozz/nautilus-terminal/blob/master/nautilus_terminal/__main__.py))
* **0.1:**
* Initial release of Win32 Details

0 comments on commit 94fa942

Please sign in to comment.