Skip to content

Commit 13cb137

Browse files
2 parents c852ce5 + 6c40f16 commit 13cb137

1 file changed

Lines changed: 21 additions & 17 deletions

File tree

README.md

Lines changed: 21 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -7,29 +7,18 @@
77
## Requirements
88
This project has only been tested on x64 machines, with Windows 10/11 and calibre 7. It may or may not work on different Windows systems and older Calibre versions. It requires the [.Net Framework 4.8](https://dotnet.microsoft.com/en-us/download/dotnet-framework/net48).
99

10-
## Installation
11-
Rather than providing a Setup executable, the installation process is done through a PowerShell script. The installation is "portable", since the user can place the necessary DLLs and launch the Setup script from any folder. Just as easily the DLLs can be uninstalled via the same script.
12-
13-
1) Download the [latest release](https://github.com/unalignedcoder/CalibreImportShellExtension/releases).
14-
2) Extract the files to a folder of your choice.
15-
3) Run the `Setup.ps1` Powershell script. The script will register the Dll, add the necessary Registry entries and optionally restart Explorer, so as to make the new context menu entry immediately available. Read inside the Setup script for more instructions.
16-
17-
<img src="https://github.com/user-attachments/assets/f85511a8-d1fc-4d10-ba34-97b96805d8dd" width=50% />
18-
19-
2010
## Usage
2111
The user can right-click on any eBook in their File Explorer, and select "Import to Calibre". By "eBook" we mean the files currently supported by Calibre. This app will retrieve such list dynamically from the registry, and it usually corresponds to the following file extensions:
2212

2313
`.epub, .pdf, .mobi, .azw, .azw3, .fb2, .djvu, .lrf, .rtf, .txt, .doc, .docx, .odt, .htm, .html, .cbz, .cbr, .pdb, .snb, .tcr, .zip, .rar`.
2414

25-
<img src="https://github.com/user-attachments/assets/cb9bac8c-f8c8-4ce1-9a6b-9cce01ba1dea" width=90% />
26-
15+
![image](https://github.com/user-attachments/assets/07c6ea38-aa46-42d4-8a3e-7f6f9f6d88db)
2716

2817
The user selection can include one file or multiple files. Such multiple files can have any of the supported extensions. The entry submenu will offer a list of all Calibre libraries presently in the system.
2918

3019
Alternatively, the user can use a dialog window rather than the submenu. The functionality is the same.
3120

32-
<img src="https://github.com/user-attachments/assets/8b9679bb-0943-44a6-ace3-8145c8a0b661" width=50% />
21+
<img src="https://github.com/user-attachments/assets/8b9679bb-0943-44a6-ace3-8145c8a0b661" width=60% />
3322

3423
Once the import has concluded, the user will be prompted to start Calibre and directly open the library into which the ebooks have been imported.
3524

@@ -50,14 +39,29 @@ The Settings window sets some important options.
5039
## Localization
5140
The app is AI-translated in the following langauges:
5241
* Chinese
53-
* Spanish
54-
* German
42+
* Czech
43+
* English
5544
* French
45+
* German
5646
* Italian
47+
* Japanese
48+
* Korean
49+
* Polish
50+
* Portoguese
51+
* Russian
52+
* Spanish
53+
* Turkish
54+
55+
The Logging is always done in English.
56+
57+
## Installation
58+
Rather than providing a Setup executable, the installation process is done through a PowerShell script. The installation is "portable", since the user can place the necessary DLLs and launch the Setup script from any folder. Just as easily the DLLs can be uninstalled via the same script.
5759

58-
The logging is always done in English.
60+
1) Download the [latest release](https://github.com/unalignedcoder/CalibreImportShellExtension/releases).
61+
2) Extract the files to a folder of your choice.
62+
3) Run the `Setup.ps1` Powershell script. The script will register the Dll, add the necessary Registry entries and optionally restart Explorer, so as to make the new context menu entry immediately available. Read inside the Setup script for more instructions.
5963

60-
## Removal
64+
## Uninstallation
6165
Removing this Shell extension is just as easy. The user can simply run the Setup script with the `-u` parameter. All Registry entries will be deleted and the DLLs unregistered. All is left is to manually delete the folder with the files.
6266

6367

0 commit comments

Comments
 (0)