Delete README.MD
This commit is contained in:
parent
ae88bb9866
commit
b2eaa009d4
1 changed files with 0 additions and 117 deletions
117
README.MD
117
README.MD
|
|
@ -1,117 +0,0 @@
|
|||
# Nautilus-Universal-File-Converter
|
||||
|
||||
A versatile Nautilus (Files) script designed to provide a universal file conversion utility directly within your file manager's context menu.
|
||||
|
||||
## 🚀 Overview
|
||||
|
||||
This script empowers your Nautilus file manager with robust file conversion capabilities. Instead of opening separate applications or remembering complex command-line syntax, you can now right-click on a variety of file types (videos, audio, images, and more) and convert them to your desired format with a few clicks. It's built to simplify your workflow for common conversion tasks, providing a seamless and integrated experience.
|
||||
<video src="assets/demo.mp4" controls="controls"/></br>
|
||||
|
||||
## ✨ Features
|
||||
|
||||
* **Context Menu Integration:** Accessible via right-click on any selected file(s) in Nautilus.
|
||||
* **Multi-Format Support:** Leverages powerful backend tools (`ffmpeg`, `imagemagick`) to handle a wide array of video, audio, and image formats.
|
||||
* **Intuitive Interface:** Uses `zenity` for graphical dialogs, allowing you to easily select output formats, quality settings, or conversion profiles.
|
||||
* **Flexible Output:** Create new files in the same directory, or be prompted for a new location/name.
|
||||
* **Error Handling:** Provides user-friendly feedback for successful conversions or any encountered issues.
|
||||
|
||||
## 📋 Requirements
|
||||
|
||||
This script relies on the following command-line tools for its conversion magic:
|
||||
|
||||
* **`ffmpeg`**: Essential for video/audio format conversions.
|
||||
* **`imagemagick`**: Used for image format changes, resizing, etc.
|
||||
* **`zenity`**: For creating the interactive graphical dialogs for user input and selection within Nautilus.
|
||||
|
||||
## ⚙️ Installation
|
||||
|
||||
The installation process involves two main steps: installing the required dependencies and then placing the script in the correct Nautilus scripts directory.
|
||||
|
||||
### 1. Install Dependencies
|
||||
|
||||
Below are instructions for installing `ffmpeg`, `imagemagick`, and `zenity` on major Linux distributions.
|
||||
|
||||
#### Debian/Ubuntu-based Distributions
|
||||
|
||||
```bash
|
||||
sudo apt update
|
||||
sudo apt install ffmpeg imagemagick zenity
|
||||
```
|
||||
|
||||
#### Arch Linux
|
||||
|
||||
```bash
|
||||
sudo pacman -S ffmpeg imagemagick zenity
|
||||
```
|
||||
|
||||
#### NixOS
|
||||
|
||||
On NixOS, you can install these packages either system-wide (recommended for global availability) or user-specific.
|
||||
|
||||
**System-wide (recommended - via `configuration.nix`):**
|
||||
|
||||
Add the packages to your `environment.systemPackages` in your `/etc/nixos/configuration.nix` file:
|
||||
|
||||
```nix
|
||||
# /etc/nixos/configuration.nix
|
||||
{ config, pkgs, ... }:
|
||||
|
||||
{
|
||||
# ... other configurations ...
|
||||
|
||||
environment.systemPackages = with pkgs; [
|
||||
# ... existing packages ...
|
||||
ffmpeg
|
||||
imagemagick
|
||||
zenity
|
||||
];
|
||||
|
||||
# ... other configurations ...
|
||||
}
|
||||
```
|
||||
|
||||
After modifying `configuration.nix`, rebuild and switch your system:
|
||||
|
||||
```bash
|
||||
sudo nixos-rebuild switch
|
||||
```
|
||||
|
||||
### 2. Install the Nautilus Script
|
||||
|
||||
1. **Download the script:**
|
||||
Obtain the `File Converter script from this repository.
|
||||
|
||||
2. **Create the Nautilus scripts directory:**
|
||||
If you don't already have a `scripts` directory for Nautilus, create it:
|
||||
|
||||
```bash
|
||||
mkdir -p ~/.local/share/nautilus/scripts/
|
||||
```
|
||||
|
||||
3. **Copy the script:**
|
||||
Move or copy the downloaded script into the `scripts` directory. It's recommended to name it something clear that will appear in your context menu, like `Convert File` or `Universal Converter`.
|
||||
|
||||
```bash
|
||||
cp ./File\ Converter ~/.local/share/nautilus/scripts/
|
||||
```
|
||||
|
||||
4. **Make the script executable:**
|
||||
|
||||
```bash
|
||||
chmod +x ~/.local/share/nautilus/scripts/File\ Converter
|
||||
```
|
||||
|
||||
## 🚀 Usage
|
||||
|
||||
1. **Open Nautilus (Files)** and navigate to the directory containing the file(s) you wish to convert.
|
||||
2. **Right-click** on the file you want to convert.
|
||||
3. Hover over the "Scripts" menu item.
|
||||
4. Click on "Convert File" (or whatever you named the script).
|
||||
5. A `zenity` dialog will appear, prompting you to select the desired output format, quality, or other conversion options. Follow the on-screen instructions.
|
||||
6. Once you've made your selections, the script will process the file. A progress or completion message will inform you about the conversion status. The newly converted file will typically appear in the same directory as the original, often with a new extension.
|
||||
|
||||
## 📄 License
|
||||
|
||||
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
|
||||
|
||||
---
|
||||
Loading…
Reference in a new issue