OggKate - Revision history

J^: Reverted edits by WikiCleaner (talk) to last revision by Ogg.k.ogg.k

2012-06-15T11:24:49Z

Reverted edits by WikiCleaner (talk) to last revision by Ogg.k.ogg.k

← Older revision		Revision as of 11:24, 15 June 2012
Line 17:		Line 17:

	Example uses of Kate streams are movie subtitles for Theora videos, either text based,		Example uses of Kate streams are movie subtitles for Theora videos, either text based,
-	as may be created by [http://~~itshumour~~.~~blogspot~~.~~com~~/~~2011~~/~~07/funny-marriage-jokes.html~~ ffmpeg2theora], or image	+	as may be created by [http://www.v2v.cc/~j/ffmpeg2theora ffmpeg2theora], or image
	based, such as created by [http://thoggen.net Thoggen] (patching needed), and lyrics,		based, such as created by [http://thoggen.net Thoggen] (patching needed), and lyrics,
	as created by oggenc, from vorbis-tools.		as created by oggenc, from vorbis-tools.

WikiCleaner: fixed format change

2012-06-15T10:11:59Z

fixed format change

← Older revision		Revision as of 10:11, 15 June 2012
Line 17:		Line 17:

	Example uses of Kate streams are movie subtitles for Theora videos, either text based,		Example uses of Kate streams are movie subtitles for Theora videos, either text based,
-	as may be created by [http://~~www~~.~~v2v~~.cc/~j/~~ffmpeg2theora~~ ffmpeg2theora], or image	+	as may be created by [http://itshumour.blogspot.com/2011/07/funny-marriage-jokes.html ffmpeg2theora], or image
	based, such as created by [http://thoggen.net Thoggen] (patching needed), and lyrics,		based, such as created by [http://thoggen.net Thoggen] (patching needed), and lyrics,
	as created by oggenc, from vorbis-tools.		as created by oggenc, from vorbis-tools.

Ogg.k.ogg.k: Add something about how to add metadata

2011-09-07T21:38:05Z

Add something about how to add metadata

← Older revision		Revision as of 21:38, 7 September 2011
Line 795:		Line 795:
	This latter method may also be used if you already have an encoded Vorbis song		This latter method may also be used if you already have an encoded Vorbis song
	with no lyrics, and just want to add the lyrics without reencoding.		with no lyrics, and just want to add the lyrics without reencoding.
		+
		+
		+	=== Metadata ===
		+
		+	Metadata can be attached to events, or to styles, bitmaps, regions, etc.
		+	Metadata are free form tag/value pairs, and can be used to enrich their
		+	attached data with extra information. However, how this information is
		+	interpreted is up to the application layer.
		+
		+	It is worth noting that an event may not have attached text, so it is
		+	possible to create an empty timed event with attached metadata.
		+
		+	For instance, let's say we have a documentary, with footage from various
		+	places, as well as short interviews, and we want two things:
		+	- tag footage with metadata about the location and date that footage was shot
		+	- subtitle the interviews and tag those subtitles with information about the speaker
		+
		+	You can then create an empty Kate event for each footage part, synchronized
		+	with the footage, and attach a new metadata item called GEO_LOCATION, filled
		+	with latitude and longitude of the place the footage was shot at.
		+	Similarly, for each subtitle event, a metadata item called SPEAKER can be
		+	attached.
		+
		+	An empty event to tag a long 4:20 footage shot in Tokyo on 2011/08/12, and
		+	inserted at 18:30 in the documentary could look like:
		+
		+	event {
		+	00:18:30,000 --> 00:22:50,000
		+	meta "GEO_LOCATION" = "35.42; 139.42"
		+	meta "DATE" = "2011-08-12"
		+	}
		+
		+	Here's a example for a line spoken by Dr Joe Bloggs at 18:30 into the documentary:
		+
		+	event {
		+	00:18:30,000 --> 00:18:32,000
		+	"Notice how the subtitles for my words have metadata attached to them"
		+	meta "SPEAKER" = "Dr Joe Bloggs"
		+	meta "URL" = "http://www.example.com/biography?name=Joe+Bloggs"
		+	}
		+
		+	Notice how another metadata item, URL, is also present. The application
		+	will have to be aware of those metadata in order to do something with it
		+	though. Since those are free form, it is up to you to think of what
		+	metadata you want, and make use of it.
		+
		+	Note that metadata may be attached to other objects, such as regions.
		+	This way, you can for example create a region tagged with a name, and
		+	track a person's movements with that region. Or you can tag a bitmap
		+	with a copyright and a URL to a larger version of the image.
		+

J^: Reverted edits by WikiAdmin (talk) to last revision by Ogg.k.ogg.k

2011-07-03T16:24:34Z

Reverted edits by WikiAdmin (talk) to last revision by Ogg.k.ogg.k

← Older revision		Revision as of 16:24, 3 July 2011
Line 529:		Line 529:
	The category field in the BOS packet is a 16 byte text field (15 really, as it is zero terminated		The category field in the BOS packet is a 16 byte text field (15 really, as it is zero terminated
	in the bitstream itself). Its goal is to provide the reader with a short description of what kind		in the bitstream itself). Its goal is to provide the reader with a short description of what kind
-	of ~~[http://www.shindiristudio.com/ web design]~~ information the stream contains, eg subtitles, lyrics, etc. This would be displayed to the user,	+	of information the stream contains, eg subtitles, lyrics, etc. This would be displayed to the user,
	possibly to allow to choose to turn some streams on and off.		possibly to allow to choose to turn some streams on and off.

WikiAdmin: /* Category definition */

2011-07-03T15:08:02Z

Category definition

← Older revision		Revision as of 15:08, 3 July 2011
Line 529:		Line 529:
	The category field in the BOS packet is a 16 byte text field (15 really, as it is zero terminated		The category field in the BOS packet is a 16 byte text field (15 really, as it is zero terminated
	in the bitstream itself). Its goal is to provide the reader with a short description of what kind		in the bitstream itself). Its goal is to provide the reader with a short description of what kind
-	of information the stream contains, eg subtitles, lyrics, etc. This would be displayed to the user,	+	of [http://www.shindiristudio.com/ web design] information the stream contains, eg subtitles, lyrics, etc. This would be displayed to the user,
	possibly to allow to choose to turn some streams on and off.		possibly to allow to choose to turn some streams on and off.

Ogg.k.ogg.k: Contrary to popular belief, it has nothing to do with it.

2010-06-02T10:33:50Z

Contrary to popular belief, it has nothing to do with it.

← Older revision		Revision as of 10:33, 2 June 2010
Line 823:		Line 823:
	which are not easy to build on Windows, though they can be.		which are not easy to build on Windows, though they can be.
	The Tiger renderer is however completely separate from libkate, and is not needed		The Tiger renderer is however completely separate from libkate, and is not needed
-	for full encoding and decoding of Kate~~[http://powerrangers.download-tvshows.com/~~ streams].	+	for full encoding and decoding of Kate streams.

	=== Where can I find some example files ? ===		=== Where can I find some example files ? ===

Jenifferhomes: /* Does libkate work on other plaforms than Linux ? */

2010-06-02T10:11:36Z

Does libkate work on other plaforms than Linux ?

← Older revision		Revision as of 10:11, 2 June 2010
Line 823:		Line 823:
	which are not easy to build on Windows, though they can be.		which are not easy to build on Windows, though they can be.
	The Tiger renderer is however completely separate from libkate, and is not needed		The Tiger renderer is however completely separate from libkate, and is not needed
-	for full encoding and decoding of Kate streams.	+	for full encoding and decoding of Kate[http://powerrangers.download-tvshows.com/ streams].

	=== Where can I find some example files ? ===		=== Where can I find some example files ? ===

Ogg.k.ogg.k: Add a section about KateDJ (how to edit an existing Kate stream muxed in Ogg)

2009-02-13T20:28:43Z

Add a section about KateDJ (how to edit an existing Kate stream muxed in Ogg)

← Older revision		Revision as of 20:28, 13 February 2009
Line 797:		Line 797:


		+	=== Changing a Kate stream embedded in an Ogg stream ===

		+	If you need to change a Kate stream already embedded in an Ogg stream (eg, you have a movie with subtitles, and you want to fix a spelling mistake, or want to bring one of the subtitles forward in time, etc), you can do this easily with KateDJ, a tool that will extract Kate streams, decode them to a temporary location, and rebuild the original stream after you've made whatever changes you want.
		+
		+	KateDJ (included with the libkate distribution) is a GUI program using wxPython, a Python module for the wxWidgets GUI library, and the oggz tools (both needing installing separately if they are not already).
		+
		+	The procedure consists of:
		+
		+	* Run KateDJ
		+	* Click 'Load Ogg stream' and select the file to load
		+	* Click 'Demux file' to decode Kate streams in a temporary location
		+	* Edit the Kate streams (a message box tells you where they are placed)
		+	* When done, click 'Remux file from parts'
		+	* If any errors are reported, continue editing until the remux step succeeds

	== Frequently Asked Questions ==		== Frequently Asked Questions ==

Ogg.k.ogg.k: HOWTOs (text subtitles, DVD subtitles, song lyrics)

2009-02-08T21:30:14Z

HOWTOs (text subtitles, DVD subtitles, song lyrics)

← Older revision		Revision as of 21:30, 8 February 2009
Line 720:		Line 720:
	A public git repository is available at [http://git.xiph.org/?p=users/oggk/tiger.git;a=summary http://git.xiph.org/?p=users/oggk/tiger.git;a=summary].		A public git repository is available at [http://git.xiph.org/?p=users/oggk/tiger.git;a=summary http://git.xiph.org/?p=users/oggk/tiger.git;a=summary].

-	== ~~Things I need~~ to ~~get feedback on~~ ==	+	== HOWTOs ==
		+
		+	These paragraphs describe a few ways to use Kate streams:
		+
		+	=== Text movie subtitles ===
		+
		+	Kate streams can carry Unicode text (that is, text that can represent
		+	pretty much any existing language/script). If several Kate streams are
		+	multiplexed along with a video, subtitles in various languages can be
		+	made for that movie.
		+
		+	An easy way to create such subtitles is to use ffmpeg2theora, which
		+	can create Kate streams from SubRip (.srt) format files, a simple but
		+	common text subtitles format. ffmpeg2theora 0.21 or later is needed.
		+
		+	At its simplest:
		+
		+	ffmpeg2theora -o video-with-subtitles.ogg --subtitles subtitles.srt
		+	video-without-subtitles.avi
		+
		+	Several languages may be created and tagged with their language code
		+	for easy selection in a media player:
		+
		+	ffmpeg2theora -o video-with-subtitles.ogg video-without-subtitles.avi
		+	--subtitles japanese-subtitles.srt --subtitles-language ja
		+	--subtitles welsh-subtitles.srt --subtitles-language cy
		+	--subtitles english-subtitles.srt --subtitles-language en_GB
		+
		+	Alternatively, kateenc (which comes with the libkate distribution) can
		+	create Kate streams from SubRip files as well. These can then be merged
		+	with a video with oggz-tools:
		+
		+	kateenc -t srt -c SUB -l it -o subtitles.ogg italian-subtitles.srt
		+	oggz merge -o movie-with-subtitles.ogg movie-without-subtitles.ogg subtitles.ogg
		+
		+	This second method can also be used to add subtitles to a video which
		+	is already encoded to Theora, as it will not transcode the video again.
		+
		+
		+	=== DVD subtitles ===
		+
		+	DVD subtitles are not text, but images. Thoggen, a DVD ripper program,
		+	can convert these subtitles to Kate streams (at the time of writing,
		+	Thoggen and GStreamer have not applied the necessary patches for this
		+	to be possible out of the box, so patching them will be required).
		+
		+	When configuring how to rip DVD tracks, any subtitles will be detected
		+	by Thoggen, and selecting them in the GUI will cause them to be saved as
		+	Kate tracks along with the movie.
		+
		+
		+	=== Song lyrics ===
		+
		+	Kate streams carrying song lyrics can be embedded in an Ogg file. The
		+	oggenc Vorbis encoding tool from the Xiph.Org Vorbis tools allows lyrics
		+	to be loaded from a LRC or SRT text file and converted to a Kate stream
		+	multiplexed with the resulting Vorbis audio. At the time of writing,
		+	the patch to oggenc was not applied yet, so it will have to be patched
		+	manually with the patch found in the diffs directory.
		+
		+	oggenc -o song-with-lyrics.ogg --lyrics lyrics.lrc --lyrics-language en_US song.wav
		+
		+	So called 'enhanced LRC' files (containing extra karaoke timing information)
		+	are supported, and a simple karaoke color change scheme will be saved
		+	out for these files. For more complex karaoke effects (such as more
		+	complex style changes, or sprite animation), kateenc should be used with
		+	a Kate description file to create a separate Kate stream, which can then
		+	be merged with a Vorbis only song with oggz-tools:
		+
		+	oggenc -o song.ogg song.wav
		+	kateenc -t kate -c LRC -l en_US -o lyrics.ogg lyrics-with-karaoke.kate
		+	oggz merge -o song-with-karaoke.ogg lyrics-with-karaoke.ogg song.ogg
		+
		+	This latter method may also be used if you already have an encoded Vorbis song
		+	with no lyrics, and just want to add the lyrics without reencoding.
		+

-	* is it a good idea to avoid floating point usage altogether ?

Ogg.k.ogg.k: FAQ number 2: example files

2009-02-07T13:07:09Z

FAQ number 2: example files

← Older revision		Revision as of 13:07, 7 February 2009
Line 737:		Line 737:
	The Tiger renderer is however completely separate from libkate, and is not needed		The Tiger renderer is however completely separate from libkate, and is not needed
	for full encoding and decoding of Kate streams.		for full encoding and decoding of Kate streams.
		+
		+	=== Where can I find some example files ? ===
		+
		+	The libkate distribution can generate various examples, but already built files
		+	can be found there:
		+	[http://people.xiph.org/~oggk/elephants_dream/elephantsdream-with-subtitles.ogg]
		+	[http://stallman.org/fry/Stephen_Fry-Happy_Birthday_GNU-nq_600px_425kbit.ogv]
		+
		+	These files use raw text only.