Documentation:Snapshots - Revision history

DoesItReallyMatter: Tweaks, correction: "Snapshot" menu item should be "Take Snapshot"

2019-02-12T06:24:39Z

Tweaks, correction: "Snapshot" menu item should be "Take Snapshot"

← Older revision		Revision as of 06:24, 12 February 2019
Line 1:		Line 1:
	{{RightMenu\|Documentation TOC}}		{{RightMenu\|Documentation TOC}}
	There are two ways to take snapshots (i.e., screenshots or frame grabs) with VLC:		There are two ways to take snapshots (i.e., screenshots or frame grabs) with VLC:
	#Open the ''Video'' menu, and select the ''Snapshot'' menu item.		#Open the ''Video'' menu, and select the ''Take Snapshot'' menu item.
	#Press the snapshot hotkey		#Press the snapshot hotkey
	#*Linux / Unix / Windows (Qt ~~interface~~): <kbd>Shift+s</kbd>		#*Linux / Unix / Windows (Qt Interface): <kbd>Shift+s</kbd>
	#*Mac OS X: <kbd>Command+Alt+s</kbd>		#*Mac OS X: <kbd>Command+Alt+s</kbd>

	When a snapshot is taken, it will briefly preview as a thumbnail with its filename and then fade away.		When a snapshot is taken, it will briefly preview as a thumbnail with its filename and then fade away.

	To change the hotkey, go to Tools → Preferences. If "Show settings" is set to Simple, click Hotkeys; if "Show settings" is set All, navigate to Interface → Hotkeys settings. Set the hotkey for Take video snapshot.		To change the hotkey, go to Tools → Preferences. If "Show settings" is set to Simple, click Hotkeys; if "Show settings" is set to All, navigate to Interface → Hotkeys settings. Set the hotkey for Take video snapshot.

	==Snapshot location, format and name==		==Snapshot location, format and name==
Line 17:		Line 17:
	*Windows Vista, 7, 8, and 10: "%HOMEPATH%\Pictures\"		*Windows Vista, 7, 8, and 10: "%HOMEPATH%\Pictures\"
	*Linux / Unix: ~/Pictures		*Linux / Unix: ~/Pictures
	*~~Mac OS X~~: Desktop/		*macOS: Desktop/

	===Configuring snapshot options under Windows:===		===Configuring snapshot options under Windows:===
	[[File:Basic snapshots config.png\|550px\|left\|alt=]]
			[[File:Basic snapshots config.png\|550px\|left\|alt=\|Snapshots dialogue under Windows]]
	{{Clear\|left}}		{{Clear\|left}}
	The location, format and name of snapshots may be changed in the ''Preferences'' menu item in the ''Tools'' tab, subsection ''Video''.		The location, format and name of snapshots may be changed in the ''Preferences'' menu item in the ''Tools'' tab, subsection ''Video''.

	The default format for snapshots is PNG, but this may be changed to JPEG. Also, the default name for snapshots is ''vlcsnap-'' followed by a timestamp that is ''not'' the time of the frame in the video you're viewing, but rather the current date and time—as in 2014-01-16-14h57m19s163.		The default format for snapshots is [[PNG]], but this may be changed to [[JPEG]]. Also, the default name for snapshots is ''vlcsnap-'' followed by a timestamp that is ''not'' the time of the frame in the video you're viewing, but rather the current date and time—as in 2014-01-16-14h57m19s163.

	Also, you may substitute other text for ''vlcsnap-'' in the ''Video snapshot file prefix'' and you may choose to have snapshots numbered sequentially (i.e., 000001, 000002, 000003, and so on) instead of with a timestamp.		Also, you may substitute other text for ''vlcsnap-'' in the ''Video snapshot file prefix'' and you may choose to have snapshots numbered sequentially (i.e., 000001, 000002, 000003, and so on) instead of with a timestamp.

	As of version 0.9.0, you may even use ~~[[Documentation:Play HowTo/Format String\|~~variables]] in the text used for the filename. For example, ''$T'' (must be upper case) will insert the video's time code into the file name. If you were to change the prefix to ''Friends-$T-'' while watching a DVD of ''Friends'', then the snapshot filenames would look something like this: ''Friends-00_05_21-2014-01-16-14h57m19s163.png''. This indicates a snapshot taken at 5 minutes and 21 seconds into the video; and it was taken on this day at this time: ''2014-01-16-14h57m19s163''.		As of version 0.9.0, you may even use variables in the text used for the filename. For example, ''$T'' (must be upper case) will insert the video's time code into the file name. If you were to change the prefix to ''Friends-$T-'' while watching a DVD of ''Friends'', then the snapshot filenames would look something like this: ''Friends-00_05_21-2014-01-16-14h57m19s163.png''. This indicates a snapshot taken at 5 minutes and 21 seconds into the video; and it was taken on this day at this time: ''2014-01-16-14h57m19s163''.

	For a shorter file name, check the "Sequential numbering" option in the configuration box (below). Instead of numbers like ''2014-01-16-14h57m19s163'', VLC will simply insert the count of snapshots for that session—for example, ''00004''. Thus, in the example above, a snapshot with sequential numbering would look like this: ''Friends-00_05_21-000001.png''		For a shorter file name, check the "Sequential numbering" option in the configuration box (below). Instead of numbers like ''2014-01-16-14h57m19s163'', VLC will simply insert the count of snapshots for that session—for example, ''00004''. Thus, in the example above, a snapshot with sequential numbering would look like this: ''Friends-00_05_21-000001.png''

DoesItReallyMatter: /* Configuring snapshot options under Windows: */ Cosmetics

2019-02-12T05:55:01Z

Configuring snapshot options under Windows:: Cosmetics

← Older revision		Revision as of 05:55, 12 February 2019
Line 24:		Line 24:
	The location, format and name of snapshots may be changed in the ''Preferences'' menu item in the ''Tools'' tab, subsection ''Video''.		The location, format and name of snapshots may be changed in the ''Preferences'' menu item in the ''Tools'' tab, subsection ''Video''.

	The default format for snapshots is PNG, but this may be changed to JPEG. Also, the default name for snapshots is ''vlcsnap-'' followed by a timestamp that is ''not'' the time of the frame in the video you're viewing, but rather the current date and time--as in 2014-01-16-14h57m19s163.		The default format for snapshots is PNG, but this may be changed to JPEG. Also, the default name for snapshots is ''vlcsnap-'' followed by a timestamp that is ''not'' the time of the frame in the video you're viewing, but rather the current date and time—as in 2014-01-16-14h57m19s163.

	Also, you may substitute other text for ''vlcsnap-'' in the ''Video snapshot file prefix'' and you may choose to have snapshots numbered sequentially (i.e., 000001, 000002, 000003, and so on) instead of with a timestamp.		Also, you may substitute other text for ''vlcsnap-'' in the ''Video snapshot file prefix'' and you may choose to have snapshots numbered sequentially (i.e., 000001, 000002, 000003, and so on) instead of with a timestamp.

DoesItReallyMatter: /* Snapshot location, format and name */ Works for Win10

2019-02-12T05:34:01Z

Snapshot location, format and name: Works for Win10

← Older revision		Revision as of 05:34, 12 February 2019
Line 15:		Line 15:

	*Windows XP: "%HOMEPATH%\My Pictures\"		*Windows XP: "%HOMEPATH%\My Pictures\"
	*Windows Vista, 7, and 8: "%HOMEPATH%\Pictures\"		*Windows Vista, 7, 8, and 10: "%HOMEPATH%\Pictures\"
	*Linux / Unix: ~/Pictures		*Linux / Unix: ~/Pictures
	*Mac OS X: Desktop/		*Mac OS X: Desktop/

DoesItReallyMatter: /* Snapshot location, format and name */ Windows environment variable "%HOMEPATH%" is code-correct here (for D:\ mounts) and will automatically expand to a username with less typing

2019-02-12T05:17:09Z

Snapshot location, format and name: Windows environment variable "%HOMEPATH%" is code-correct here (for D:\ mounts) and will automatically expand to a username with less typing

← Older revision		Revision as of 05:17, 12 February 2019
Line 14:		Line 14:
	The snapshot location depends upon your operating system:		The snapshot location depends upon your operating system:

	*Windows XP: ~~My Documents~~\My Pictures\		*Windows XP: "%HOMEPATH%\My Pictures\"
	*Windows Vista, 7, and 8: ~~C:\Users\''Username''~~\Pictures\		*Windows Vista, 7, and 8: "%HOMEPATH%\Pictures\"
	*Linux / Unix: ~/Pictures		*Linux / Unix: ~/Pictures
	*Mac OS X: Desktop/		*Mac OS X: Desktop/

DoesItReallyMatter: /* Snapshot location, format and name */ The Linux / Unix code $(HOME) was incorrect and potentially dangerous, it would try to call a program with name HOME (however unlikely). Fixing/updating

2019-02-12T05:04:02Z

Snapshot location, format and name: The Linux / Unix code $(HOME) was incorrect and potentially dangerous, it would try to call a program with name HOME (however unlikely). Fixing/updating

← Older revision		Revision as of 05:04, 12 February 2019
Line 16:		Line 16:
	*Windows XP: My Documents\My Pictures\		*Windows XP: My Documents\My Pictures\
	*Windows Vista, 7, and 8: C:\Users\''Username''\Pictures\		*Windows Vista, 7, and 8: C:\Users\''Username''\Pictures\
	*Linux / Unix: ~~$(HOME)/.vlc~~/		*Linux / Unix: ~/Pictures
	*Mac OS X: Desktop/		*Mac OS X: Desktop/

DoesItReallyMatter: Cosmetics

2019-02-12T04:52:45Z

Cosmetics

← Older revision		Revision as of 04:52, 12 February 2019
Line 3:		Line 3:
	#Open the ''Video'' menu, and select the ''Snapshot'' menu item.		#Open the ''Video'' menu, and select the ''Snapshot'' menu item.
	#Press the snapshot hotkey		#Press the snapshot hotkey
	#*Linux / Unix / Windows (Qt interface): Shift-s		#*Linux / Unix / Windows (Qt interface): <kbd>Shift+s</kbd>
	#*Mac OS X: Command-Alt-s		#*Mac OS X: <kbd>Command+Alt+s</kbd>

	When a snapshot is taken, it will briefly preview as a thumbnail with its filename and then fade away.		When a snapshot is taken, it will briefly preview as a thumbnail with its filename and then fade away.

	To change the hotkey, go to Tools -> Preferences. If "Show settings" is set to Simple, click Hotkeys; if "Show settings" is set All, navigate to Interface -> Hotkeys settings. Set the hotkey for Take video snapshot.		To change the hotkey, go to Tools → Preferences. If "Show settings" is set to Simple, click Hotkeys; if "Show settings" is set All, navigate to Interface → Hotkeys settings. Set the hotkey for Take video snapshot.

	==Snapshot location, format and name==		==Snapshot location, format and name==
Line 20:		Line 20:

	===Configuring snapshot options under Windows:===		===Configuring snapshot options under Windows:===
			[[File:Basic snapshots config.png\|550px\|left\|alt=]]
			{{Clear\|left}}
	The location, format and name of snapshots may be changed in the ''Preferences'' menu item in the ''Tools'' tab, subsection ''Video''.		The location, format and name of snapshots may be changed in the ''Preferences'' menu item in the ''Tools'' tab, subsection ''Video''.

	~~[[File:Basic_snapshots_config.png]]~~

	The default format for snapshots is PNG, but this may be changed to JPEG. Also, the default name for snapshots is ''vlcsnap-'' followed by a timestamp that is ''not'' the time of the frame in the video you're viewing, but rather the current date and time--as in 2014-01-16-14h57m19s163.		The default format for snapshots is PNG, but this may be changed to JPEG. Also, the default name for snapshots is ''vlcsnap-'' followed by a timestamp that is ''not'' the time of the frame in the video you're viewing, but rather the current date and time--as in 2014-01-16-14h57m19s163.
Line 30:		Line 30:
	As of version 0.9.0, you may even use [[Documentation:Play HowTo/Format String\|variables]] in the text used for the filename. For example, ''$T'' (must be upper case) will insert the video's time code into the file name. If you were to change the prefix to ''Friends-$T-'' while watching a DVD of ''Friends'', then the snapshot filenames would look something like this: ''Friends-00_05_21-2014-01-16-14h57m19s163.png''. This indicates a snapshot taken at 5 minutes and 21 seconds into the video; and it was taken on this day at this time: ''2014-01-16-14h57m19s163''.		As of version 0.9.0, you may even use [[Documentation:Play HowTo/Format String\|variables]] in the text used for the filename. For example, ''$T'' (must be upper case) will insert the video's time code into the file name. If you were to change the prefix to ''Friends-$T-'' while watching a DVD of ''Friends'', then the snapshot filenames would look something like this: ''Friends-00_05_21-2014-01-16-14h57m19s163.png''. This indicates a snapshot taken at 5 minutes and 21 seconds into the video; and it was taken on this day at this time: ''2014-01-16-14h57m19s163''.

	For a shorter file name, check the "Sequential numbering" option in the configuration box (below). Instead of numbers like ''2014-01-16-14h57m19s163'', VLC will simply insert the count of snapshots for that session--for example, ''00004''. Thus, in the example above, a snapshot with sequential numbering would look like this: ''Friends-00_05_21-000001.png''		For a shorter file name, check the "Sequential numbering" option in the configuration box (below). Instead of numbers like ''2014-01-16-14h57m19s163'', VLC will simply insert the count of snapshots for that session—for example, ''00004''. Thus, in the example above, a snapshot with sequential numbering would look like this: ''Friends-00_05_21-000001.png''

	For a full list of variables, please see [[Documentation:Play HowTo/Format String]].		For a full list of variables, please see [[Documentation:Play HowTo/Format String]].

	{{Documentation}}		{{Documentation}}

DoesItReallyMatter: Linux / Unix now has same interface as Windows, with same hotkey

2019-02-12T04:41:05Z

Linux / Unix now has same interface as Windows, with same hotkey

← Older revision		Revision as of 04:41, 12 February 2019
Line 3:		Line 3:
	#Open the ''Video'' menu, and select the ''Snapshot'' menu item.		#Open the ''Video'' menu, and select the ''Snapshot'' menu item.
	#Press the snapshot hotkey		#Press the snapshot hotkey
	#*Linux / Unix~~: Ctrl-Alt-s~~		#*Linux / Unix / Windows (Qt interface): Shift-s
	#*Windows (Qt interface): Shift-s
	#*Mac OS X: Command-Alt-s		#*Mac OS X: Command-Alt-s

Jeremy Butler: formatting

2014-01-16T16:06:33Z

formatting

← Older revision		Revision as of 16:06, 16 January 2014
Line 19:		Line 19:
	*Linux / Unix: $(HOME)/.vlc/		*Linux / Unix: $(HOME)/.vlc/
	*Mac OS X: Desktop/		*Mac OS X: Desktop/

			===Configuring snapshot options under Windows:===
			The location, format and name of snapshots may be changed in the ''Preferences'' menu item in the ''Tools'' tab, subsection ''Video''.

			[[File:Basic_snapshots_config.png]]

	The default format for snapshots is PNG, but this may be changed to JPEG. Also, the default name for snapshots is ''vlcsnap-'' followed by a timestamp that is ''not'' the time of the frame in the video you're viewing, but rather the current date and time--as in 2014-01-16-14h57m19s163.		The default format for snapshots is PNG, but this may be changed to JPEG. Also, the default name for snapshots is ''vlcsnap-'' followed by a timestamp that is ''not'' the time of the frame in the video you're viewing, but rather the current date and time--as in 2014-01-16-14h57m19s163.

	~~The location, format and name of snapshots may be changed in the ''Preferences'' menu item in the ''Tools'' tab.~~ Also, you may substitute other text for ''vlcsnap-'' in the ''Video snapshot file prefix'' and you may choose to have snapshots numbered sequentially (i.e., 000001, 000002, 000003, and so on) instead of with a timestamp.		Also, you may substitute other text for ''vlcsnap-'' in the ''Video snapshot file prefix'' and you may choose to have snapshots numbered sequentially (i.e., 000001, 000002, 000003, and so on) instead of with a timestamp.

	~~[[File:Basic_snapshots_config.png]]~~

	As of version 0.9.0, you may even use [[Documentation:Play HowTo/Format String\|variables]] in the text used for the filename. For example, ''$T'' (must be upper case) will insert the video's time code into the file name. If you were to change the prefix to ''Friends-$T-'' while watching a DVD of ''Friends'', then the snapshot filenames would look something like this: Friends-00_05_21-2014-01-16-14h57m19s163.png. This indicates a snapshot taken at 5 minutes and 21 seconds into the video; and it was taken on this day at this time: 2014-01-16-14h57m19s163.		As of version 0.9.0, you may even use [[Documentation:Play HowTo/Format String\|variables]] in the text used for the filename. For example, ''$T'' (must be upper case) will insert the video's time code into the file name. If you were to change the prefix to ''Friends-$T-'' while watching a DVD of ''Friends'', then the snapshot filenames would look something like this: ''Friends-00_05_21-2014-01-16-14h57m19s163.png''. This indicates a snapshot taken at 5 minutes and 21 seconds into the video; and it was taken on this day at this time: ''2014-01-16-14h57m19s163''.

	For a shorter file name, check the "Sequential numbering" option in the configuration box (below). Instead of numbers like 2014-01-16-14h57m19s163, VLC will simply insert the count of snapshots for that session--for example, 00004.		For a shorter file name, check the "Sequential numbering" option in the configuration box (below). Instead of numbers like ''2014-01-16-14h57m19s163'', VLC will simply insert the count of snapshots for that session--for example, ''00004''. Thus, in the example above, a snapshot with sequential numbering would look like this: ''Friends-00_05_21-000001.png''

	For a full list of variables, please see [[Documentation:Play HowTo/Format String]].		For a full list of variables, please see [[Documentation:Play HowTo/Format String]].

	~~Configuring snapshot options under Windows~~

	{{Documentation}}		{{Documentation}}

Jeremy Butler: /* Snapshot location, format and name */ formatting; added clarification

2014-01-16T15:59:20Z

Snapshot location, format and name: formatting; added clarification

← Older revision		Revision as of 15:59, 16 January 2014
Line 16:		Line 16:

	*Windows XP: My Documents\My Pictures\		*Windows XP: My Documents\My Pictures\
			*Windows Vista, 7, and 8: C:\Users\''Username''\Pictures\
	*Windows Vista and 7: C:\Users\''Username''\Pictures\

	*Linux / Unix: $(HOME)/.vlc/		*Linux / Unix: $(HOME)/.vlc/

	*Mac OS X: Desktop/		*Mac OS X: Desktop/

			The default format for snapshots is PNG, but this may be changed to JPEG. Also, the default name for snapshots is ''vlcsnap-'' followed by a timestamp that is ''not'' the time of the frame in the video you're viewing, but rather the current date and time--as in 2014-01-16-14h57m19s163.

	The ~~default~~ format ~~for~~ snapshots ~~is PNG, but this~~ may be changed ~~to JPEG~~. Also, ~~the default name~~ for ~~snapshots is~~ ''vlcsnap-'' ~~followed by a timestamp that is~~ ''~~not~~'' ~~the time of the frame in the video~~ you~~'re viewing~~, ~~but rather the current name~~.		The location, format and name of snapshots may be changed in the ''Preferences'' menu item in the ''Tools'' tab. Also, you may substitute other text for ''vlcsnap-'' in the ''Video snapshot file prefix'' and you may choose to have snapshots numbered sequentially (i.e., 000001, 000002, 000003, and so on) instead of with a timestamp.

	~~The location~~, ~~format and name of snapshots~~ may ~~be changed~~ in the ''~~Preferences~~'' ~~menu item in~~ the '~~'Tools'' tab~~. ~~Also,~~ you ~~may substitute other text for~~ ''~~vlcsnap~~-'' ~~in the~~ ''~~Video snapshot file prefix~~'' ~~and you may choose to have snapshots numbered sequentially (i~~.e.~~, 000001, 000002, 000003,~~ and so on~~) instead of with a timestamp~~.		[[File:Basic_snapshots_config.png]]

			As of version 0.9.0, you may even use [[Documentation:Play HowTo/Format String\|variables]] in the text used for the filename. For example, ''$T'' (must be upper case) will insert the video's time code into the file name. If you were to change the prefix to ''Friends-$T-'' while watching a DVD of ''Friends'', then the snapshot filenames would look something like this: Friends-00_05_21-2014-01-16-14h57m19s163.png. This indicates a snapshot taken at 5 minutes and 21 seconds into the video; and it was taken on this day at this time: 2014-01-16-14h57m19s163.

	~~As of version 0.9.0~~, ~~you may even use [[Documentation:Play HowTo/Format String\|variables]]~~ in the ~~text used for the filename. For example, ''$T''~~ (~~must be upper case~~) ~~will insert the video's time code into the file name~~. ~~If you were to change the prefix to ''Friends~~-$T-~~'' while watching a DVD of ''Friends''~~, ~~then~~ the ~~snapshot filenames would look something like this: Friends~~-~~00_05_21~~-00004~~.png . This indicates a snapshot taken at 5 minutes and 21 seconds into the video; and it was the number 00004 snapshot of the day~~.		For a shorter file name, check the "Sequential numbering" option in the configuration box (below). Instead of numbers like 2014-01-16-14h57m19s163, VLC will simply insert the count of snapshots for that session--for example, 00004.

	For a full list of variables, please see [[Documentation:Play HowTo/Format String]].		For a full list of variables, please see [[Documentation:Play HowTo/Format String]].

	~~[[File:Basic_snapshots_config.png]]~~

	Configuring snapshot options under Windows		Configuring snapshot options under Windows

	{{Documentation}}		{{Documentation}}

Corbax at 15:57, 25 September 2013

2013-09-25T15:57:10Z

← Older revision		Revision as of 15:57, 25 September 2013
Line 1:		Line 1:
	{{RightMenu\|~~documentation play howto toc~~}}		{{RightMenu\|Documentation TOC}}
	There are two ways to take snapshots (i.e., screenshots or frame grabs) with VLC:		There are two ways to take snapshots (i.e., screenshots or frame grabs) with VLC:
	#Open the ''Video'' menu, and select the ''Snapshot'' menu item.		#Open the ''Video'' menu, and select the ''Snapshot'' menu item.