images => Documentation/images
Robert McRackan
|
Before Width: | Height: | Size: 18 KiB After Width: | Height: | Size: 18 KiB |
|
Before Width: | Height: | Size: 336 B After Width: | Height: | Size: 336 B |
|
Before Width: | Height: | Size: 6.7 KiB After Width: | Height: | Size: 6.7 KiB |
|
Before Width: | Height: | Size: 5.2 KiB After Width: | Height: | Size: 5.2 KiB |
|
Before Width: | Height: | Size: 7.8 KiB After Width: | Height: | Size: 7.8 KiB |
|
Before Width: | Height: | Size: 10 KiB After Width: | Height: | Size: 10 KiB |
|
Before Width: | Height: | Size: 38 KiB After Width: | Height: | Size: 38 KiB |
|
Before Width: | Height: | Size: 6.6 KiB After Width: | Height: | Size: 6.6 KiB |
|
Before Width: | Height: | Size: 8.9 KiB After Width: | Height: | Size: 8.9 KiB |
|
Before Width: | Height: | Size: 44 KiB After Width: | Height: | Size: 44 KiB |
|
Before Width: | Height: | Size: 35 KiB After Width: | Height: | Size: 35 KiB |
|
Before Width: | Height: | Size: 4.7 KiB After Width: | Height: | Size: 4.7 KiB |
|
Before Width: | Height: | Size: 3.9 KiB After Width: | Height: | Size: 3.9 KiB |
|
Before Width: | Height: | Size: 19 KiB After Width: | Height: | Size: 19 KiB |
|
Before Width: | Height: | Size: 4.2 KiB After Width: | Height: | Size: 4.2 KiB |
|
Before Width: | Height: | Size: 4.1 KiB After Width: | Height: | Size: 4.1 KiB |
|
Before Width: | Height: | Size: 46 KiB After Width: | Height: | Size: 46 KiB |
|
Before Width: | Height: | Size: 47 KiB After Width: | Height: | Size: 47 KiB |
|
Before Width: | Height: | Size: 44 KiB After Width: | Height: | Size: 44 KiB |
|
Before Width: | Height: | Size: 20 KiB After Width: | Height: | Size: 20 KiB |
|
Before Width: | Height: | Size: 21 KiB After Width: | Height: | Size: 21 KiB |
|
Before Width: | Height: | Size: 4.2 KiB After Width: | Height: | Size: 4.2 KiB |
|
Before Width: | Height: | Size: 14 KiB After Width: | Height: | Size: 14 KiB |
|
Before Width: | Height: | Size: 4.7 KiB After Width: | Height: | Size: 4.7 KiB |
|
Before Width: | Height: | Size: 9.7 KiB After Width: | Height: | Size: 9.7 KiB |
|
Before Width: | Height: | Size: 23 KiB After Width: | Height: | Size: 23 KiB |
|
Before Width: | Height: | Size: 29 KiB After Width: | Height: | Size: 29 KiB |
|
Before Width: | Height: | Size: 56 KiB After Width: | Height: | Size: 56 KiB |
|
Before Width: | Height: | Size: 7.7 KiB After Width: | Height: | Size: 7.7 KiB |
|
Before Width: | Height: | Size: 6.0 KiB After Width: | Height: | Size: 6.0 KiB |
|
Before Width: | Height: | Size: 14 KiB After Width: | Height: | Size: 14 KiB |
62
README.md
@ -76,49 +76,49 @@ To install Libation, extract the zip file to a folder, for example `C:\Libation`
|
|||||||
|
|
||||||
Create your account(s):
|
Create your account(s):
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
New locale options include many more regions including old audible accounts which pre-date the amazon acquisition
|
New locale options include many more regions including old audible accounts which pre-date the amazon acquisition
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### Import your library
|
### Import your library
|
||||||
|
|
||||||
Select Import > Scan Library:
|
Select Import > Scan Library:
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Or if you have multiple accounts, you'll get to choose whether to scan all accounts or just the ones you select:
|
Or if you have multiple accounts, you'll get to choose whether to scan all accounts or just the ones you select:
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
If this is a new installation, or you're scanning an account you haven't scanned before, you'll be prompted to enter your password for the Audible account.
|
If this is a new installation, or you're scanning an account you haven't scanned before, you'll be prompted to enter your password for the Audible account.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Enter the password and click Submit. Audible will prompt you with a CAPTCHA image.
|
Enter the password and click Submit. Audible will prompt you with a CAPTCHA image.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Enter the CAPTCHA answer characters and click Submit. If all has gone well, Libation will start scanning the account.
|
Enter the CAPTCHA answer characters and click Submit. If all has gone well, Libation will start scanning the account.
|
||||||
|
|
||||||
In rare instances, the Captcha image/response will fail in an endless loop. If this happens, delete the problem account, and then click Save. Re-add the account and click Save again. Now try to scan the account again. This time, instead of typing your password, click the link that says "Or click here". This will open the Audible External Login dialog shown below.
|
In rare instances, the Captcha image/response will fail in an endless loop. If this happens, delete the problem account, and then click Save. Re-add the account and click Save again. Now try to scan the account again. This time, instead of typing your password, click the link that says "Or click here". This will open the Audible External Login dialog shown below.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
You can either copy the URL shown and paste it into your browser or launch the browser directly by clicking Launch in Browser. Audible will display its standard login page. Login, including answering the CAPTCHA on the next page. In some cases, you might have to approve the login from the email account associated with that login, but once the login is successful, you'll see an error message.
|
You can either copy the URL shown and paste it into your browser or launch the browser directly by clicking Launch in Browser. Audible will display its standard login page. Login, including answering the CAPTCHA on the next page. In some cases, you might have to approve the login from the email account associated with that login, but once the login is successful, you'll see an error message.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
This actually means you've successfully logged in. Copy the entire URL shown in your browser and return to Libation. Paste that URL into the text box at the bottom of the Audible External Login window and click Submit.
|
This actually means you've successfully logged in. Copy the entire URL shown in your browser and return to Libation. Paste that URL into the text box at the bottom of the Audible External Login window and click Submit.
|
||||||
|
|
||||||
You'll see this window while it's scanning:
|
You'll see this window while it's scanning:
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Success! We see how many new titles are imported:
|
Success! We see how many new titles are imported:
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### Download your books -- DRM-free!
|
### Download your books -- DRM-free!
|
||||||
|
|
||||||
@ -134,25 +134,25 @@ The stoplights will tell you a title's status:
|
|||||||
|
|
||||||
Or hover over the button to see the status.
|
Or hover over the button to see the status.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Select Liberate > Begin Book Backups
|
Select Liberate > Begin Book Backups
|
||||||
|
|
||||||
You can also click on the stop light to download only that title and its PDF
|
You can also click on the stop light to download only that title and its PDF
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
First the original book with DRM is downloaded
|
First the original book with DRM is downloaded
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Then it's decrypted so you can use it on any device you choose. The very first time you decrypt a book, this step will take a while. Every other book will go much faster. The first time, Libation has to figure out the special decryption key which allows your personal books to be unlocked.
|
Then it's decrypted so you can use it on any device you choose. The very first time you decrypt a book, this step will take a while. Every other book will go much faster. The first time, Libation has to figure out the special decryption key which allows your personal books to be unlocked.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
And voila! If you have multiple books not yet liberated, Libation will automatically move on to the next.
|
And voila! If you have multiple books not yet liberated, Libation will automatically move on to the next.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
The Audible id must be somewhere in the book's file or folder name for Libation to detect your downloaded book.
|
The Audible id must be somewhere in the book's file or folder name for Libation to detect your downloaded book.
|
||||||
|
|
||||||
@ -162,15 +162,15 @@ For books which include PDF downloads, Libation can download these for you as we
|
|||||||
|
|
||||||
Select Liberate > Begin PDF Backups
|
Select Liberate > Begin PDF Backups
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
The downloads work just like with books, only with no additional decryption needed.
|
The downloads work just like with books, only with no additional decryption needed.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### Details of downloaded files
|
### Details of downloaded files
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
When you set up Libation, you'll specify a Books directory. Libation looks inside that directory and all subdirectories to look for files or folders with each library book's audible id. This way, organization is completely up to you. When you download + decrypt a book, you get several files
|
When you set up Libation, you'll specify a Books directory. Libation looks inside that directory and all subdirectories to look for files or folders with each library book's audible id. This way, organization is completely up to you. When you download + decrypt a book, you get several files
|
||||||
|
|
||||||
@ -179,7 +179,7 @@ When you set up Libation, you'll specify a Books directory. Libation looks insid
|
|||||||
|
|
||||||
### Export your library
|
### Export your library
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Export your library to Excel, CSV, or JSON
|
Export your library to Excel, CSV, or JSON
|
||||||
|
|
||||||
@ -189,15 +189,15 @@ Export your library to Excel, CSV, or JSON
|
|||||||
|
|
||||||
To add tags to a title, click the tags button
|
To add tags to a title, click the tags button
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Add as many tags as you'd like. Tags are separated by a space. Each tag can contain letters, numbers, and underscores
|
Add as many tags as you'd like. Tags are separated by a space. Each tag can contain letters, numbers, and underscores
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Tags are saved non-case specific for easy search. There is one special tag "hidden" which will also grey-out the book
|
Tags are saved non-case specific for easy search. There is one special tag "hidden" which will also grey-out the book
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
To edit tags, just click the button again.
|
To edit tags, just click the button again.
|
||||||
|
|
||||||
@ -211,7 +211,7 @@ Libation's advanced searching is built on the powerful Lucene search engine. Sim
|
|||||||
* Full official guide: https://lucene.apache.org/core/2_9_4/queryparsersyntax.html
|
* Full official guide: https://lucene.apache.org/core/2_9_4/queryparsersyntax.html
|
||||||
* Tons of search fields, specific to audiobooks
|
* Tons of search fields, specific to audiobooks
|
||||||
* Synonyms so you don't have to memorize magic words. Eg: author and author**s** will both work
|
* Synonyms so you don't have to memorize magic words. Eg: author and author**s** will both work
|
||||||
* Click [?] button for a full list of search fields and synonyms 
|
* Click [?] button for a full list of search fields and synonyms 
|
||||||
* Search by tag like \[this\]
|
* Search by tag like \[this\]
|
||||||
* When tags have an underscore you can use part of the tag. This is useful for quick categories. The below examples make this more clear.
|
* When tags have an underscore you can use part of the tag. This is useful for quick categories. The below examples make this more clear.
|
||||||
|
|
||||||
@ -219,25 +219,25 @@ Libation's advanced searching is built on the powerful Lucene search engine. Sim
|
|||||||
|
|
||||||
Search for anything with the word potter
|
Search for anything with the word potter
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
If you only want to see Harry Potter
|
If you only want to see Harry Potter
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
If you only want to see potter except for Harry Potter. You can also use "-" instead of "NOT"
|
If you only want to see potter except for Harry Potter. You can also use "-" instead of "NOT"
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
To see only books written by Neil Gaiman where he also narrates his own book. (If you don't include AND, you'll see everything written by Neil Gaiman and also all books in your library which are self-narrated.)
|
To see only books written by Neil Gaiman where he also narrates his own book. (If you don't include AND, you'll see everything written by Neil Gaiman and also all books in your library which are self-narrated.)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
I tagged autobiographies as auto_bio and biographies written by someone else as bio. I can get only autobiographies with \[auto_bio\] or get both by searching \[bio\]
|
I tagged autobiographies as auto_bio and biographies written by someone else as bio. I can get only autobiographies with \[auto_bio\] or get both by searching \[bio\]
|
||||||
|
|
||||||
![Search example: \[bio\]](images/SearchExampleBio.png)
|
![Search example: \[bio\]](Documentation/imagesSearchExampleBio.png)
|
||||||
![Search example: \[auto_bio\]](images/SearchExampleAutoBio.png)
|
![Search example: \[auto_bio\]](Documentation/imagesSearchExampleAutoBio.png)
|
||||||
|
|
||||||
### Filters
|
### Filters
|
||||||
|
|
||||||
@ -247,7 +247,7 @@ To edit this list go to Quick Filters > Edit quick filters. Here you can re-orde
|
|||||||
|
|
||||||
Check "Quick Filters > Start Libation with 1st filter Default" to have your top filter automatically applied when Libation starts. In this top example, I want to always start without these: at books I've tagged hidden, books I've tagged as free_audible_originals, and books which I have rated.
|
Check "Quick Filters > Start Libation with 1st filter Default" to have your top filter automatically applied when Libation starts. In this top example, I want to always start without these: at books I've tagged hidden, books I've tagged as free_audible_originals, and books which I have rated.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
## Advanced
|
## Advanced
|
||||||
|
|
||||||
|
|||||||