Closed AncientAbysswalker closed 1 year ago
Thank you for reporting this issue - I'm always especially interested in documentation problem reports, because this is something, everyone can benefit from.
Let's see if I can break down your problems into bullet points to get a better overview:
--taggers
option - it is not to specify the import formats, but to specify, which taggers should be used (a small difference, but important)ChptFmtNativeFormat
in the documentation (which indeed should be added)The todo's:
--taggers
(It is an option for advanced users and not necessary for default tasks)ChptFmtNative
works as import format, if the correct parameters are usedAnd now how it works:
<audio-file-name>.chapters.txt
(e.g. my-audio-book.m4b
maps to my-audio-book.chapters.txt
)
tone dump --format=chptfmtnative my-audio-book.m4b > my-audio-book.chapters.txt
to dump existing chapters*.chapters.txt
to your likingtone tag --auto-import=chapters my-audio-book.m4b
to reimport modified chaptersIf this does not work as expected, please feel free to give feedback.
Thanks for the quick response! I believe you are 100% correct in that I misunderstood the workflow due to the lack of documentation on the feature. I tested out the feature using the updated information you provided and I was able to successfully add chapters as intended! :) I believe those listed updates to the documentation should be enough to clarify the workflow.
On a side note, I think that --format=chptfmtnative
is not available to me yet, as the comments in the commit seem to indicate version 0.1.1 release and I think the most recent release for Windows is 0.1.0 :)
On a side note, I think that --format=chptfmtnative is not available to me yet, as the comments in the commit seem to indicate version 0.1.1 release and I think the most recent release for Windows is 0.1.0 :)
Ah sorry, yes, it's in the upcoming 0.1.1
- but I'm happy you solved your problem. The docs will be updated for 0.1.1
, too. Thank you again for reporting this.
There is not currently enough info to understand how to add chapters to the Metadata. The documentation states that all that is required is the command
tone tag --taggers="ChptFmtNative" [file]
and the chapter data found inchapters.txt
(assumedly in the same directory that the [file] is in - but I also tried the current directory and the user home directory) will be added. There is no indication of what format or interface to use. After reading through your tests it seems that the format to use is something like00:00:00.000 chapter 1 \n00:00:05.000 chapter 2 \n00:00:15.000 chapter 3
. This should be indicated. Despite this, it doesn't make any changes and simply statesunchanged: [file]
, and does not give any indication whether the file was picked up or not. More information should be added to the documentation to make this process much clearer... I have also tried adding the --debug flag and changing the name of the chapters file and nothing changes.Using: Windows 10 and Powershell