chapterEditor(Chapter-Database Disc2mkv Matroska-Tools[Tags,Menu,Multi-MKV])+CLI

[hubblec4]

Hi everyone

I have started for a while with a simple and small chapter Editor project.


The project has grown and now are 4 diffrent Format Editors avalible and an editor for muxing multi editions mkvs
(like Xin1Generator).


There is now a Reddit for chapterEditor.


Matroska Multi-MKV Editor

With this editor you can create easy and fast multi-mkv files from normal Matroska files(mkv,mka,mk3d).
Only the chapters and tags are replaced and no video or audio data is manipulated.

You can download here some tutorial videos.



Multi-Editions-Editor (MEE):

With this editor you can backup your Blu-Ray to mkv.
If there are multiple editions on the BluRay, they can be stored in a space-saving mkv with "ordered chapters".

here an old Tutorial(with rev0.14)


Matroska Menu Editor (MME)

The new MME helping a while Matroska files (mkv, mka, mk3d) that are located in a folder and
the same specifications (number of tracks in the correct order and the same codecs for video, audio, subs) have,
to connect with each other via the menu.
In this case, no files need to be remuxed.
Tutorial-Video

DVD2mkv:
is a small tool to quickly mux the tracks on a DVD to a mkv. Functions for edit the mkv's are also available.

Matroska Tags: With this editor you can provided Matroska files with Tags. Tags contain useful information that can be collected and processed by other programs.


Functions:

supported file formats:

• 3GPP TTXT File
• Apple file formats .mp4 .m4a .m4v (required: MKVToolNix)
• Bluray/mpls
• BSPlayer (ini)
• BSPlayer (chf)
• CCE (csv)
• CCE SP Text File
• Celltimes Text
• ChapterGrabber.chapters File
• CueSheet (cue)
• DGIndexNV.dgi File
• DVD Author Text File
• DVD IFO (VTS_xx_0.IFO)
• FFmpeg MetaData (txt) // new
• ffprobe (xml and json)
• GrassValley Edius V2+V3 (csv)
• HC Enc Text file
• Hybrid(Selur) chapterqueue CHP File
• Hybrid(Selur) mkvchapter CHP File
• Matroska Files
• MediaInfo (txt)
• Micro DVD Player (ini)
• multiAVCHD Text File
• Muxman
• OGG Chapter Text File
• Premiere (csv)
• qpf File (MeGUI)
• Scenarist SD (csv)
• Scenarist BD (tsv)
• Sonic Cinevision CSV File
• Sonic Scenarist CSV File
• Spruce DVD Maestro CHP File
• SVCD (hhmmsscc) (txt)
• Timecodes Text File
• Timecode lists Text File, Format HH:MM:SS:ff
• TMPGEnc .keyframe file
• tsMuxer Meta File
• YouTube chapters from comments
• VLC bookmark files
• WebM files
• x264 qp text file
• xml Matroska chapters file

Special tools:

• multi chapter
• online chapter database
• Haali's TRACKSETEX: (required: MKVToolNix)
  
• Matroska Tags: (optional: MKVToolNix)

Editors:

• OGG Format
• XML Format -> simple Tags Editor
• TTXT 3GPP Format
• multiAVCHD Format
• Multi Editions mkv(BD2mkv) (required: eac3to ; MKVToolNix)
• Matroska Menu (required: MKVToolNix)
• DVD2mkv (required: PgcDemuxMod , BDSup2Sub++1.0.2_win32.exe and MKVToolNix ; optional: DGIndexNV)
• Converter // new

Additional functions for the chapter editors (OGG, XML, TTXT, multiAVCHD)

• FPS Conversion
• simple Chapter naming
• improved Chapter naming with the online chapter database
• Chapter time adjustment
• Chapter time trimming
• for XML Format: append files, automatic "ordered chapter" end times generation

Languages:

• German
• English
• Italian

CLI support (GUI)



chapterEditor rev1.xx
download chapterEditor(rev1.44 Windows)
download chapterEditor(rev1.44 Linux)


This version is deprecated and no longer supported. Furthermore, a maximum of MKVToolNix version 19 can be used.
download chapterEditor(rev0.51)


Alternate download on Softpedia or Videohelp.

You find here chapter samples and here new samples.

*****************************************************************************************************************
********** chapterEditorCLI **********

cE CLI is a small command line tool with which you can generate chapter files from the chapter database.
Furthermore, you can create Blu-Rays or DVDs chapter files and expand the chapter names from the database.
The chapter files can be output in OGG format or Matroska XML format.


download chapterEditorCLI(rev0.01)

chapterEditorCLI(rev0.01) help
---------------------------

-a / --anleitung  The help on german

-f / --fps         FPS Conversion switch
"FPS value"      source/target fps value
"file path"        source/target file path or a folder

-h / --help       Show this help

--mid             Movie ID, an integer greater then 0
                  Displays all movie information and chapters

--names           Save a simple chapter names list of a movie
                  output: a file name without an extension

--ogg             Output format: ogg-chapter.txt
                  output: a file name without an extension

--pass            your database password

--range           A Movie ID. Displays the following 200 movies

--title           Displays all movies(max: 200) with titles
                  (at least 2 characters)

--user            your database user name

--xml             Output format: matroska-xml-chapter.xml
                  output: a file name without an extension

X: / X:\          a drive

"path DVD"        a DVD path to VIDEO_TS folder
"path Blu-Ray"    a Blu-Ray path to BDMV or PLAYLIST folder

VTS_xx_0          VTS ifo file: xx = 01 .. 99
                  without the ".ifo" extension

1..99             a title number for VTS ifo file

00000..99999      a mpls file/number without the ".mpls" extension

---------------------------
Mode 1: database syntax
1-2.parameter:  --user="your name" --pass="your password"
3.parameter:    --mid= OR --range= OR --title="a title"
  If 3.parameter equal  --mid  you can enter a 4. parameter
4.parameter:    --ogg="output txt" OR --xml="output xml" OR
                --names="file path and name"

---------------------------
Mode 2: DVD/Blu-Ray/folder syntax
1.parameter:    Drive(X:) OR a folder path "DVD/Blu-Ray path"
*** Blu-Ray ***
2.parameter:    00000..99999
3.parameter:    --ogg="output txt" OR --xml="output xml"
  generate a chapter file with chapter names
4-6.parameters: --user="your name" --pass="your password" --mid=
*** DVD ***
2.parameter:    VTS_xx_0
3.parameter:    1..99
4.parameter:    --ogg="output txt" OR --xml="output xml"
  generate a chapter file with chapter names
5-7.parameters: --user="your name" --pass="your password" --mid=

NOTE:
File names can be empty, a default file is then created in the root directory.

---------------------------
Mode 3: FPS Conversion syntax
1. parameter:   -f or --fps (FPS init)
2. parameter:   24000/1001 or 23.976 (source fps)
3. parameter:   30 or 23,97 (target fps)
4. parameter:   "source file path or source folder"
5. parameter:   "target file path" (optional and for source file only)

examples:
Mode 1:

Viewing the movie information and list of chapters

chapterEditorCLI.exe --user="username" --pass="the password" --mid=99

Display more films and list the movie information (200)

chapterEditorCLI.exe --user="username" --pass="the password" --range=99

List all movies from a specific title (max: 200)

chapterEditorCLI.exe --user="username" --pass="the password" --title="cap"

Creating a chapter file

chapterEditorCLI.exe --user="username" --pass="the password" --mid=99 --ogg="c:\path\chapter file"
chapterEditorCLI.exe --user="username" --pass="the password" --mid=99 --xml=

A chapter list of names without having to spend specifying a location / file name

chapterEditorCLI.exe --user="username" --pass="the password" --mid=32000 --names=

Mode 2:

Drive(Blu-Ray or DVD) or folder

chapterEditorCLI.exe D:
chapterEditorCLI.exe D:\a folder\BDMV
chapterEditorCLI.exe D:\a folder\BDMV\PLAYLIST
chapterEditorCLI.exe D:\a folder\VIDEO_TS

-Blu-Ray
Choose an MPLS and list the chapter times

chapterEditorCLI.exe D: 00001

Creating a chapter file

chapterEditorCLI.exe D: 00001 --ogg=
chapterEditorCLI.exe D: 00001 --xml="c:\chapter file"

-DVD
Choose an IFO and view the track numbers

chapterEditorCLI.exe D: VTS_01_0

Display a title of the IFO and list the chapter

chapterEditorCLI.exe D: VTS_01_0 3

Creating a chapter file

chapterEditorCLI.exe D: VTS_01_0 3 --ogg=
chapterEditorCLI.exe D: VTS_01_0 3 --xml="c:\chapter file"

-Output with chapter names for the chapter files, it will be appended 3 parameters for Blu-Ray and DVD

--user="username" --pass="the password" --mid=99

Modus 3:
It is expected at least 4 parameters.
FPS conversion always starts with the -f or --fps switch
a Matroska XML file from 24000/1001 to 25 FPS without target file path

chapterEditorCLI.exe -f 24000/1001 25 "D:\Matroska chapter.xml"
(a new target file is automatically created in the same folder)

an OGG Chapter file from 29,97 to 23.976 FPS with new name and target (the file extension is automatically assigned)

chapterEditorCLI.exe -f 29,97 23.976 "D:\OGG Chapter file.txt" "E:\new OGG file"
(FPS float values can be specified with a point or comma)

convert an entire folder with source files

chapterEditorCLI.exe -f 24000/1001 25 "D:\folder with source files(\)"

[Guest]

Thanks, hubblec4! Contributions such as yours are what make Doom9 the wonderful place that we all love.

Best wishes for a prosperous and joyful 2014.

[hubblec4]

my english is not so good and the translation of the changelog is made by google.
I try to give my best to support english.

Best wishes back to you.

[hubblec4]

a mini tiny small error has crept in the procurement of the end times.

extra-make a new version now would be too much of a good.

please you downloaded the version again.

[mariner]

Greetings hubbleC4.

Would it be possible to add support for multiAVCHD chapter format?

Many thanks and best regards.

[hubblec4]

Originally Posted by mariner

Would it be possible to add support for multiAVCHD chapter format?

have you a sample for me, i dont use multiAVCHD ?

[mariner]

Thanks for the kind reply, hubbleC4.

It seems to take the following format. See attached.

Many thanks and best regards.

chap.txt

[hubblec4]

00:00:00.000	 	Chapter1Line1\nChapter1Line2\nChapter1Line3\nChapter1Line4	00:00:00.999
00:10:00.000	 	Chapter2Line1\nChapter2Line2\nChapter2Line3\nChapter2Line4	00:10:00.999
00:20:00.000	 	Chapter3Line1\nChapter3Line2\nChapter3Line3\nChapter3Line4	00:20:00.999

Note:
1) The time codes ending with 000 are chapter position.
2) The time codes ending with 999 are chapter thumb position.
3) Total of 4 descriptive lines supported, separated by \n.
4) Not clear about the field left blank.

The red colored time codes are the normal chapters and it will be easy to support it.

For what are the blue entries? (Maybe chapter names?)

The green time codes are these used for anything?

[mariner]

1. The blue entries are the chapter name(s). Dean provided a very generous 4 lines for this.

2. The green entries are the time position of the thumbs to appear in the chapters menu page.. If none specified, the midway point between the current and the next chapter is used.

3. There could be a 4th parameter sandwiched between time code and name, but could not figure out what it is. So use a <space> between the two <tab> characters.

The attached screen caps should be self explanatory.

[hubblec4]

I asked deank for the specs of his own chapter format.

brainstorming :

in what for a format would you convert the multiAVCHD.chapter?

// OGG
I can use the first timecode and the 4-Chaptername-Lines (generate one line with one chapter name) to convert it to ogg.chapter.
The last timecodes(thumbs) can not be used.

// XML
The firsttimecode is normal starttime.
The 4-Chaptername-Lines should be compressed to one line, because the chaptername-system in XML works different to the 4-Chaptername-Lines-system of multiAVCHD.
It is possible to generate more chapternames for the chaptertimestamp but the player will shown only the first chaptername at the moment. there is no splitter(or player) avalible that can handle this mkv-feature.
The last timecodes(thumbs) could be stored as nested chapters.

// 3GPP TTXT
The firsttimecode is normal starttime.
The 4-Chaptername-Lines can be saved in the same way. 3GPP TTXT supported Multi-chaptername-lines.
The last timecodes(thumbs) can not be used.


the chaptername-line are ever 4? what is when set no chaptername or only one chapterline, how looks the chapter.file now?

i hope deank will give me the specs then it will be easy to support it.

[mariner]

Originally Posted by hubblec4

I asked deank for the specs of his own chapter format.

brainstorming :

in what for a format would you convert the multiAVCHD.chapter?

I would like to convert from others to multiAVCHD .txt format, so that multiAVCHD can process it.

Originally Posted by hubblec4

the chaptername-line are ever 4? what is when set no chaptername or only one chapterline, how looks the chapter.file now?

It will look like (assuming no time code for thumb):

00:00:00.000
00:10:00.000	 	Chapter2Line1

Thanks and best regards.

[hubblec4]

Originally Posted by mariner

I would like to convert from others to multiAVCHD .txt format, so that multiAVCHD can process it.

i understand. multiAVCHD istn't able to handel other formats and you must set the chapters manually in the "chapter-editor-page" of multiAVCHD.
A solution will be i write a new own format editor for multiAVCHD which supports other formats. But i think this take a bit time.
without the right syntax of the chapter.files could be hard.

I will think about it, but i don't promise anything.

[mariner]

That would be splendid.

Thank you and best regards.

[hubblec4]

i have tested a bit multiAVCHD.
The chapters can saved with or without the chaptername(s) and the thumbtime.
without: the chapterformat is the same like Timecodes Text File (see the chapter sample folder).

multiAVCHD is able to handle to following chapter formats
- CCE SP Text File
- Celltimes Text
- HC Enc Text file
- Muxman
- OGG Chapter Text File
- Timecodes Text File

of what for a format you would like convert it to mulitAVCHD.chapter?

can you explain me what is the number right of the "apply"-button?

[mariner]

Originally Posted by hubblec4

i have tested a bit multiAVCHD.
The chapters can saved with or without the chaptername(s) and the thumbtime.
without: the chapterformat is the same like Timecodes Text File (see the chapter sample folder).

That is correct.
The multiAVCHD chapters txt file is basically a
Timecodes Text File with chapter name and thumbnail position.

Originally Posted by hubblec4

multiAVCHD is able to handle to following chapter formats
- CCE SP Text File
- Celltimes Text
- HC Enc Text file
- Muxman
- OGG Chapter Text File
- Timecodes Text File

of what for a format you would like convert it to mulitAVCHD.chapter?

I'm not familiar these formats, can they handle multi-line chapter name?

Originally Posted by hubblec4

can you explain me what is the number right of the "apply"-button?

The number 12 in the screen cap?
That's the number of chapters multiAVCHD will create if the auto button is clicked.

Many thanks and best regards.

[hubblec4]

Originally Posted by mariner

I'm not familiar these formats, can they handle multi-line chapter name?

No, this formats store the chapter time only (timecodes or frames).
multiAVCHD works not perfect with frame-based chapter formats.
there is a standard source fps set (i think 24000/1001), but you can't change it.

Originally Posted by mariner

The number 12 in the screen cap?
That's the number of chapters multiAVCHD will create if the auto button is clicked.

ok. the number itself is not used in the chapter file.

at the moment i work on some fixes and improvements but i add it to my todo list.

i plan the same support like the other editors(formats,FPS,Naming,Time adjustment and cuting).

you would like to have a "auto" button to generate thumbnail positions?

what you need too?

but it will take a while, maybe on next revision.

[mariner]

An option to auto generate thumbnail positions would be great indeed.

Many thank and best regards.

[von Suppé]

Great tool, thanks hubblec4

[hubblec4]

hi mariner

i need your help to write a perfect procedur for the auto-thumbnail position button.

multiAVCHD set for the last chapter a thumbnail position thats greater as the chapter time. is this correct?
to generate the middle time of two chapters is easy but the last chapter has no next chapter.
Which time should be used?

[mariner]

Chapter time is used for thumbnail position if it is the last chapter.

Perhaps you'd like to consider doing the same for the other chapters as well. So if no thumbnail is specified, multiAVCHD can default to using the midway point for thumbnail position.