diff --git a/.gitignore b/.gitignore index 81f491cf..993b71b6 100644 --- a/.gitignore +++ b/.gitignore @@ -1,2 +1,6 @@ # Prevent overwriting user config config.yaml + +# Ignore generated documents but keep the docs directory +docs/* +!docs/.gitkeep diff --git a/build-docs b/build-docs index 71951e58..271c985d 100755 --- a/build-docs +++ b/build-docs @@ -141,8 +141,9 @@ TEMPLATE_Document="${TEMPLATE_DIR}/document.html" TEMPLATE_Header="${TEMPLATE_DIR}/header.html" TEMPLATE_Footer="${TEMPLATE_DIR}/footer.html" -# clean -rm -rf "${DOCS_DIR}"/* +# clean docs dir +mkdir -p "${DOCS_DIR}" +$(GLOBIGNORE='*.gitkeep'; rm -rf "${DOCS_DIR}"/*) # build cp -R "${TEMPLATE_DIR}"/fonts "${TEMPLATE_DIR}"/style "${SOURCE_DIR}"/* "${DOCS_DIR}"/ diff --git a/docs/.gitkeep b/docs/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/docs/en/latest/get-handbrake/check-for-updates.html b/docs/en/latest/get-handbrake/check-for-updates.html deleted file mode 100644 index 38b580c3..00000000 --- a/docs/en/latest/get-handbrake/check-for-updates.html +++ /dev/null @@ -1,38 +0,0 @@ - - - - - - - HandBrake Documentation - Checking for updates - - - -
-
-
English Docs > HandBrake Latest > Checking for updates
-
-

Checking for updates

- -

HandBrake can let you know when a newer version is available, and even automatically download and install available updates.

- -

Before updating, make sure there are pending encodes in the Queue and make note of any custom presets you have created, as they may not be compatible with the newer version.

- -

From the main menu, navigate to HandBrake and select Check for Updates....

- -

Check for Updates menu item

- -

If an update is available, you will be given the opportunity to install it right away. To enable automatic updates, select the appropriate checkbox labeled Automatically download and install updates in the future.

- -

Check for Updates dialog

- -

Next steps

- -

Continue to Opening a video.

- -
- - diff --git a/docs/en/latest/get-handbrake/download-and-install.html b/docs/en/latest/get-handbrake/download-and-install.html deleted file mode 100644 index caf301c7..00000000 --- a/docs/en/latest/get-handbrake/download-and-install.html +++ /dev/null @@ -1,76 +0,0 @@ - - - - - - - HandBrake Documentation - Downloading and installing HandBrake - - - -
-
-
English Docs > HandBrake Latest > Downloading and installing HandBrake
-
-

Downloading and installing HandBrake

- -

HandBrake is available for Linux, OS X, and Windows, at the official HandBrake website.

- -

Downloading

- -

To download HandBrake to your computer, click the download button on the HandBrake website’s Home page. You can also choose a version for a specific operating system from the Downloads page.

- -

Experienced users may wish to try HandBrake’s nightly builds1.

- -

Installing

- -

Once you’ve downloaded HandBrake for OS X, open the DMG file in your Downloads folder (your web browser, e.g. Safari/Chrome/Firefox, may do this for you automatically). Drag the HandBrake application to your Applications folder.

- -

Installing HandBrake on OS X

- -

HandBrake is now installed. You may eject the disk image and move it to the Trash.

- -

About OS X Gatekeeper

- -

The first time you attempt to launch HandBrake, OS X may present this warning to you:

- -

Gatekeeper warning

- -

HandBrake is not “signed” by Apple. This message doesn’t mean anything is wrong; rather, it indicates that HandBrake is not part of Apple’s paid program to validate OS X applications. Click OK to dismiss the dialog.

- -

To instruct Gatekeeper to allow HandBrake to run, press the Control key, then click the HandBrake icon, and then select Open from the shortcut menu. Gatekeeper will ask whether you are certain you wish to open HandBrake, and you may confirm that you are by clicking Open2.

- -

Gatekeeper bypass

- -

Gatekeeper confirmation

- -

Now HandBrake is up and running. You should not have to repeat the Gatekeeper process until you update HandBrake.

- -

Launching HandBrake

- -

You may launch HandBrake by quickly clicking twice (double-clicking) on the cocktail & pineapple icon.

- -

HandBrake icon

- -

Read about the icon and more at HandBrake lore (TODO: link).

- -

Next steps

- -

Continue to Checking for updates.

-
-
-
    -
  1. -

    Nightly builds are based on HandBrake’s latest development code, including new and experimental features that may be unstable or significantly different than the latest release version. Although everyone is welcome to try them, nightly builds are best suited for experienced users and developers.↩

    2. -
  2. -

    These instructions are taken directly from Apple’s OS X Gatekeeper support documents. You can learn more about Gatekeeper here and here.↩

    3. -
-
- - -
- - diff --git a/docs/en/latest/get-handbrake/where-to-get-handbrake.html b/docs/en/latest/get-handbrake/where-to-get-handbrake.html deleted file mode 100644 index 3f1c728e..00000000 --- a/docs/en/latest/get-handbrake/where-to-get-handbrake.html +++ /dev/null @@ -1,52 +0,0 @@ - - - - - - - HandBrake Documentation - Where to get HandBrake - - - -
-
-
English Docs > HandBrake Latest > Where to get HandBrake
-
-

Where to get HandBrake

- -

HandBrake releases and nightly builds

- -

Official HandBrake releases and nightly builds are available for Linux, OS X, and Windows.

- -

Ubuntu Linux users should install the official release PPA or the official snapshots PPA. The PPA may work, but is not tested, on other Debian-compatible distributions. Users of other BSD- and *nix-like distributions may compile from source.

- -

HandBrake source code is available at the official HandBrake repository on GitHub.

- -

Other versions obtained via third parties are not supported.

- -

Warning about broken third-party builds

- -

Certain Linux distributions and package repositories create their own versions of HandBrake. These modified versions are often crippled (features removed for political reasons) and broken (bugs due to modifications), and should be avoided.

- -

Broken third-party packages/builds include but are not limited to:

- - - - -

Please do not request support for these or any other unofficial versions. The HandBrake Team has zero control over them and therefore cannot provide meaningful support.

- -

Linux users should install the official release PPA, install the official snapshots PPA, or compile from the official source code.

- -

Next steps

- -

Continue to Downloading and installing HandBrake.

- -
- - diff --git a/docs/en/latest/help/community-support.html b/docs/en/latest/help/community-support.html deleted file mode 100644 index 9c1de091..00000000 --- a/docs/en/latest/help/community-support.html +++ /dev/null @@ -1,50 +0,0 @@ - - - - - - - HandBrake Documentation - Community support - - - -
-
-
English Docs > HandBrake Latest > Community support
-
-

Community support

- -

If you run into problems using HandBrake, first take a look at this documentation’s Table of contents—the information you need may be just a click away.

- -

Didn’t find it? Keep reading.

- -

Activity Logs

- -

Activity logs explain a lot and are required for all support requests. More information about [Activity Logs] (TODO: link).

- -

Community Forums

- -

The HandBrake Community Forums are available 24/7. Whether you have a support request or simply want to connect with other HandBrake users, this is the place. Registration is free. Please read and abide by our Community Rules.

- -

If you need help or have encountered an error while using HandBrake, first take a look at our Support Forums or Search using some words related to your questions. Doing this saves everyone from repeating answers to common questions. If you still haven’t found an answer, feel free to start a new support request. Make sure to read How To Request Support before posting.

- -

Developers and keen users may report reproducible bugs on the Bugs Forum. Please read the bug reporting readme before posting.

- -

IRC discussion channels

- -

Real-time chat is available on our Freenode IRC channel, #handbrake. Make sure to provide an [Activity Log] (TODO: link) when requesting support.

- -

Note that HandBrake’s developers are located in various timezones around the world, and have lives and jobs outside of HandBrake and its community. It’s possible that nobody will be able to answer your support request on IRC right away. Be patient for awhile or ask on the forums.

- -

Developer discussion happens on #handbrake-dev, which is moderated for the team’s sanity. If you’ve a developer and would like to speak on #handbrake-dev, you may ask politely on #handbrake.

- -

Next steps

- -

Continue to (TODO: link).

- -
- - diff --git a/docs/en/latest/introduction/about.html b/docs/en/latest/introduction/about.html deleted file mode 100644 index f5790161..00000000 --- a/docs/en/latest/introduction/about.html +++ /dev/null @@ -1,72 +0,0 @@ - - - - - - - HandBrake Documentation - About HandBrake - - - -
-
-
English Docs > HandBrake Latest > About HandBrake
-
-

About HandBrake

- -

What HandBrake is

- -

HandBrake is an open-source video transcoder available for Linux, OS X, and Windows, licensed under the GNU General Public License (GPL) Version 2 (TODO: license link).

- -

Everyone can use HandBrake to make videos for free.

- -

What HandBrake does

- -

HandBrake takes videos you already have and makes new ones that work on your mobile phone, tablet, TV media player, game console, computer, or web browser—nearly anything that supports modern video formats.

- -

HandBrake works with most common video files and formats, including ones created by consumer and professional video cameras, mobile devices such as phones and tablets, game and computer screen recordings, and DVD and Blu-ray discs. HandBrake leverages tools such as Libav, x264, and x265 to create new MP4 or MKV video files from these Sources.

- -

HandBrake does:

- - - - -

HandBrake can also make videos that are smaller—taking up less storage space on your device—than the originals.

- -

What HandBrake does not do

- -

HandBrake does not:

- - - - -

HandBrake also does not defeat or circumvent copy protection of any kind. It does not work with video files employing Digital Rights Management (DRM). This includes but is not limited to, copy protected content from iTunes, Amazon Video, Netflix, or other online providers, and many commercial DVD and Blu-ray discs.

- -

Applications such as AnyDVD HD for Windows and MakeMKV (TODO: link) for Linux, OS X, and Windows create DRM-free copies of DVD and Blu-ray discs that HandBrake can open; however, the HandBrake Team has no affiliation with these third parties and as such can neither recommend nor support these applications or their usage.

- -

Do not use HandBrake to copy materials you do not own or have the right to copy. If you are uncertain about your right to copy any material, you should contact your legal advisor.

- -

Next steps

- -

Continue to Where to get HandBrake.

- -
- - diff --git a/docs/en/latest/introduction/quick-start.html b/docs/en/latest/introduction/quick-start.html deleted file mode 100644 index 562194d2..00000000 --- a/docs/en/latest/introduction/quick-start.html +++ /dev/null @@ -1,90 +0,0 @@ - - - - - - - HandBrake Documentation - Quick start - - - -
-
-
English Docs > HandBrake Latest > Quick start
-
-

Quick start

- -

HandBrake takes videos you already have and makes new ones that work on your mobile phone, tablet, TV media player, game console, computer, or web browser—nearly anything that supports modern video formats.

- -

This quick start guide assumes you have already downloaded and installed HandBrake. If you do not already have HandBrake, please see Downloading and installing HandBrake.

- -

Let’s get started.

- -

Launch HandBrake

- -

Typically, you can launch HandBrake by quickly clicking twice (double-clicking) on the cocktail & pineapple icon.

- -

HandBrake icon

- -

Read about the icon and more at HandBrake lore (TODO: link).

- -

Open your original video

- -

HandBrake calls the video you already have the Source.

- -

Drag your Source video onto HandBrake to open it. You may also select the Open Source button on the toolbar and browse for it.

- -

Open Source dialog

- -

Opening a video source via drag and drop

- -

Select a title

- -

Some types of Sources contain more than one video clip, or a collection of Titles. Use HandBrake’s Title control to select which video clip you want to use. Many Sources have only one Title.

- -

Selecting a title

- -

Select a preset

- -

HandBrake provides a number of settings Presets to make your new video work well with your playback devices and software. For instance, if you have a third generation Apple TV, you may wish to select the AppleTV 3 preset. The default Normal preset is fast and relatively compatible.

- -

Selecting a preset

- -

Presets can affect compatibility (whether your video will work with your devices and software) and encoding time. Learn more: Selecting a preset

- -

Select a destination

- -

Destination is where your new video will go. You can select the Browse... button to choose a new location and name, or type it directly in the box.

- -

Selecting a destination

- -

Please take special care to note your destination. Otherwise, you won’t be able to find your new video. You can move it later if you desire.

- -

Start the encode

- -

Select the Start button on the toolbar to make your new video.

- -

Main window toolbar

- -

Starting an encode

- -

HandBrake will report its progress while it’s working and alert you when it’s finished. Then you will have a new video file at the Destination you specified.

- -

Encoding complete alert

- -

Destination video file icon

- -

Congratulations! You just encoded your first video using HandBrake. It’s now ready to watch on your devices.

- -

Next steps

- -

If you didn’t get a video file as expected, encountered an error, or had some other trouble, you can continue reading to learn more about how HandBrake works or jump right to Getting help.

- -

Continue to About HandBrake.

- -
- - diff --git a/docs/en/latest/table-of-contents.html b/docs/en/latest/table-of-contents.html deleted file mode 100644 index 9219b085..00000000 --- a/docs/en/latest/table-of-contents.html +++ /dev/null @@ -1,297 +0,0 @@ - - - - - - - HandBrake Documentation - Table of contents - - - -
-
-
English Docs > HandBrake Latest > Table of contents
-
-

Table of contents

- -

Introduction

- - - - - - - -

Getting HandBrake

- - - - -

Making videos

- - - - -

Advanced features

- - - - -

Restoration and enhancement

- - - - -

Advanced features part 2

- -

May affect compatiblity! Use a preset!

- - - - -

Getting help

- - - - -

HandBrake lore

- - - - -

CLI documentation

- - - - -

Technical documentation

- - - - -
- - diff --git a/docs/en/latest/technical/source-formats.html b/docs/en/latest/technical/source-formats.html deleted file mode 100644 index 300a57ab..00000000 --- a/docs/en/latest/technical/source-formats.html +++ /dev/null @@ -1,74 +0,0 @@ - - - - - - - HandBrake Documentation - Source formats - - - -
-
-
English Docs > HandBrake Latest > Source formats
-
-

Source formats

- -

One of HandBrake’s strengths is its ability to open a wide variety of video formats. HandBrake uses Libav under the hood and generally can open whatever Libav will, in addition to disc-based formats like DVD and Blu-ray.

- -

Note: HandBrake does not defeat or circumvent copy protection of any kind. It does not work with video files employing Digital Rights Management (DRM). See About HandBrake for more information about what HandBrake does and does not.

- -

Videos made by mobile phones, tablets, and many video cameras and DSLRs

- -

Typically, each video will be a single file that you can copy to your computer, and later open using HandBrake. Common video file types are MP4 or M4V, MOV, MPG or MPEG, and AVI.

- -

Some cameras store multiple videos in a folder structure with a playlist similar to Blu-ray discs, specifically cameras that record in AVCHD or AVCHD Lite. HandBrake may be able to open individual video files from the Stream folder inside the BDMV folder. In some cases this is not reliable, e.g. where a single video stream spans multiple files.

- -

Screen and game recordings, web videos, video editing projects, and other computer-related sources

- -

Some screen recording softwares can export or record directly to video files HandBrake can open. Common video file types are MP4 or M4V, MKV, MPG or MPEG, AVI, and WMV.

- -

HandBrake can open web videos in FLV, WEBM, MP4, and many other formats.

- -

Videos made using consumer video editing software such as iMovie must first be exported to a common video format for compatibility with HandBrake.

- -

Professional video production formats

- -

HandBrake can open a number of production formats produced by professional video cameras and NLEs, including ProRes and DNxHD.

- -

DVD, Blu-ray, AVCHD/AVCHD Lite1, and HD-DVD2 discs or disc backups

- -

HandBrake can directly open DVD and Blu-ray discs. In most situations it is better to first copy the contents to your computer’s hard drive3. Common folders are VIDEO_TS and BDMV. Common video file types are VOB, EVO, and MTS or M2TS.

- -

Certain third-party disc copy tools such as MakeMKV (TODO: link) commonly make… wait for it… MKV video files. Other tools create ISO (sometimes labeled CDR) images of DVD and Blu-ray discs. HandBrake usually can open these directly.

- -

BIN+CUE, MDF+MDS, and Toast images must first be mounted. Open the image using your operating system or appropriate software, and then open the virtual disc with HandBrake.

- -

Broadcast TV recordings

- -

HandBrake can open common video file types produced by TV recording hardware and software such as TS/MTS/M2TS, MP4 or M4V, and MPG or MPEG.

- -

Recordings made by TV-to-DVD recorders are generally supported, but do note that some recorders are known for poorly making discs. Some discs may not work due to mastering errors.

- -

Digital recordings of VHS, Beta, Video8/Hi8, LaserDisc, and other analog sources

- -

First convert your analog video to digital using a computer-based hardware recording device such as the Blackmagic Design Intensity. It is important to choose a recording device and software that allows recording to or exporting to common video formats. HandBrake can open many common video files produced by recording software, including but not limited to TS/MTS/M2TS, MP4 or M4V, MOV, MKV, MPG or MPEG, and AVI.

-
-
-
    -
  1. -

    AVCHD and AVCHD Lite playlists are not fully supported. Individual files/streams may work.↩

    2. -
  2. -

    HD-DVD playlists are not fully supported. Individual files/streams may work.↩

    3. -
  3. -

    Without special software, it is not possible to directly copy VIDEO_TS and BDMV folders from copy-protected discs.↩

    4. -
-
- - -
- - diff --git a/docs/en/latest/workflow/adjust-quality.html b/docs/en/latest/workflow/adjust-quality.html deleted file mode 100644 index 20e121af..00000000 --- a/docs/en/latest/workflow/adjust-quality.html +++ /dev/null @@ -1,75 +0,0 @@ - - - - - - - HandBrake Documentation - Adjusting quality - - - -
-
-
English Docs > HandBrake Latest > Adjusting quality
-
-

Adjusting quality

- -

HandBrake’s default settings and built-in Presets use a constant quality encoding method. This makes your new video look consistent from start to finish. Always use constant quality unless you have a specific reason not to.

- -

You can use the default setting for the Preset you selected, or adjust the quality control higher or lower depending on your tastes. Increasing quality will make your new video take up more space on your computer or playback device, whereas reducing quality will typically make your new video take up less space.

- -

Using the quality control

- -

Most of HandBrake’s built-in Presets use the x264 video encoder and a constant quality value of RF 20. A lower RF number means higher quality.

- -

To increase video quality, adjust the quality control toward the right. To reduce video quality, adjust the quality control toward the left.

- -

Quality control

- -

Begin by making small adjustments (plus or minus 1-2 RF is usually noticeable).

- -

Recommended quality settings

- -

Recommended settings for x264 are:

- - - - -

Lower quality settings may be used to produce smaller video files or for web videos where bandwidth is a concern. Drastically lower settings may show significant loss of detail.

- -

Using higher than recommended quality settings (exceeding RF 18 or so) can lead to extremely large files that may not be compatible with your devices. When in doubt, stick to the recommended range or use the default setting for the Preset you selected.

- -

Display size and viewing distance

- -

Imperfections tend to be more noticeable at larger display sizes and closer viewing distances. This is especially true for lower resolution videos (less than 720p), which are typically scaled or “blown up” to fill your display, magnifying even minor imperfections in quality.

- -

You may wish to slightly increase quality for viewing on larger displays (50 inches / 125 cm diagonal or greater), or where viewing from closer than average distances4. Reduced quality may be acceptable for viewing on smaller screens or where storage space is limited, e.g. mobile devices.

- -

Next steps

- -

Continue to Previewing your settings.

-
-
-
    -
  1. -

    SD video has a resolution of 720x480 or fewer pixels. DVDs, small web videos, and most analog sources are SD.↩

    2. -
  2. -

    720p HD video has a resolution of 1280x720 pixels. With three times the resolution of SD, and about half that of 1080p HD, 720p HD is commonly used by consumer video cameras, web videos, and broadcast TV sports.↩

    3. -
  3. -

    1080p HD video has a resolution of 1920x1080 pixels—twice the resolution of 720p and six times the resolution of 480p. 1080p HD video is commonly used by mobile phones and tablets, consumer and professional video cameras, and Blu-ray.↩

    4. -
  4. -

    Learn more about optimum viewing distances for high definition TV displays.↩

    5. -
-
- - -
- - diff --git a/docs/en/latest/workflow/open-video.html b/docs/en/latest/workflow/open-video.html deleted file mode 100644 index f33dd6a2..00000000 --- a/docs/en/latest/workflow/open-video.html +++ /dev/null @@ -1,76 +0,0 @@ - - - - - - - HandBrake Documentation - Opening a video - - - -
-
-
English Docs > HandBrake Latest > Opening a video
-
-

Opening a video

- -

In HandBrake terms, the original video you already have is called the Source. One of HandBrake’s strengths is its ability to open Sources in a wide variety of video formats, including but not limited to:

- - - - -

Learn more about source formats.

- -

Note: HandBrake does not defeat or circumvent copy protection of any kind. It does not work with video files employing Digital Rights Management (DRM). See About HandBrake for more information about what HandBrake does and does not.

- -

Using the Open Source dialog

- -

At the top of HandBrake’s main window, you’ll see a toolbar with various buttons.

- -

Main window toolbar

- -

Select the Open Source button to select the video you want to open.

- -

Open Source button

- -

Open Source dialog

- -

Dragging and dropping

- -

You can also drag and drop a video Source onto HandBrake’s main window.

- -

Opening a video source via drag and drop

- -

Next steps

- -

Great! At this point, HandBrake knows which video you want to use.

- -

If HandBrake didn’t open your video as as expected or you had some other trouble, you can continue reading to learn more about how HandBrake works or jump right to Getting help.

- -

Continue to Selecting a preset.

-
-
-
    -
  1. -

    Videos made using consumer video editing software such as iMovie must first be exported to a common video format for compatibility with HandBrake.↩

    2. -
  2. -

    AVCHD and AVCHD Lite playlists are not fully supported. Individual files/streams may work.↩

    3. -
  3. -

    HD-DVD playlists are not fully supported. Individual files/streams may work.↩

    4. -
-
- - -
- - diff --git a/docs/en/latest/workflow/preview-settings.html b/docs/en/latest/workflow/preview-settings.html deleted file mode 100644 index 029d3fc9..00000000 --- a/docs/en/latest/workflow/preview-settings.html +++ /dev/null @@ -1,72 +0,0 @@ - - - - - - - HandBrake Documentation - Previewing your settings - - - -
-
-
English Docs > HandBrake Latest > Previewing your settings
-
-

Previewing your settings

- -

Video encoding requires a lot of computer resources and can take awhile to complete. Exactly how long depends on a number of factors, including the duration, resolution, and complexity of your Source, and the settings for making your new video.

- -

Luckily, HandBrake has a Preview feature that allows you to do a test run on a few seconds or minutes of your Source, so you can see what your new video will look like without waiting for a complete encode to finish.

- -

Opening the Preview window

- -

At the top of HandBrake’s main window, you’ll see a toolbar with various buttons.

- -

Main window toolbar

- -

Select the Preview button to open the Preview window.

- -

Preview button

- -

Preview window

- -

Adjusting Preview settings

- -

Move your mouse cursor over the Preview window, and some controls will appear.

- -

Preview controls

- -

Set the starting position by dragging the Position control left or right. Choose how many seconds of video you want to encode using the Duration control. Longer durations will take more time to encode.

- -

Preview position control

- -

Preview duration control

- -

Starting a Preview encode

- -

When you’re satisfied with your starting position and duration, select Live Preview and be patient. HandBrake will report its progress while it works. When your Preview is ready, it will play automatically. You can use the playback controls to pause, rewind, and replay your Preview.

- -

Preview start control

- -

Preview playing

- -

Finishing up

- -

To create a new Preview, select the Still Previews button to start over. When you’re finished previewing your work, you may close the Preview window.

- -

Preview reset control

- -

Closing the preview window

- -

Next steps

- -

If the Preview you created was lacking in quality or otherwise not as expected, you may need to adjust quality or select a different Preset, after which you can create another Preview to see any changes.

- -

Once you are satisfied, continue to Starting encoding.

- -
- - diff --git a/docs/en/latest/workflow/select-preset.html b/docs/en/latest/workflow/select-preset.html deleted file mode 100644 index 5b5568c2..00000000 --- a/docs/en/latest/workflow/select-preset.html +++ /dev/null @@ -1,46 +0,0 @@ - - - - - - - HandBrake Documentation - Selecting a preset - - - -
-
-
English Docs > HandBrake Latest > Selecting a preset
-
-

Selecting a preset

- -

Presets, presets, presets.

- -

Selecting a Preset can go a long way toward ensuring your video works where you want it to. A Preset is a group of settings specifically tailored for the software or device you want your videos to play on.

- -

Built-in presets

- -

HandBrake includes a number of built-in Presets for various devices and general use.

- -

Presets

- -

Once you’ve opened a Source, select the Preset that most closely describes the device you want your videos to work on. For instance, if you want to play your videos on an iPad, choose the iPad Preset.

- -

Selecting a preset

- -

If your device is not listed, or you wish to play your videos on a computer, choose the Normal Preset or High Profile Preset. The Normal Preset is fast and compatible across a wide range of softwares and devices. The High Profile Preset makes better quality videos that take up less space, leaving room for a second audio track in surround sound.

- -

Custom presets

- -

If you’ve previously saved one of your own Presets, you may select it in the same way as the built-in Presets. Learn more about Custom presets (TODO: link).

- -

Next steps

- -

Continue to Adjusting quality.

- -
- - diff --git a/docs/en/latest/workflow/start-encoding.html b/docs/en/latest/workflow/start-encoding.html deleted file mode 100644 index ae6cddf9..00000000 --- a/docs/en/latest/workflow/start-encoding.html +++ /dev/null @@ -1,54 +0,0 @@ - - - - - - - HandBrake Documentation - Starting encoding - - - -
-
-
English Docs > HandBrake Latest > Starting encoding
-
-

Starting encoding

- -

Now that you’ve got all your settings just right, it’s time to make your new video!

- -

Selecting a destination

- -

Destination is where your new video will go. You can select the Browse... button to choose a new location and name, or type it directly in the box.

- -

Selecting a destination

- -

Please take special care to note your destination. Otherwise, you won’t be able to find your new video. You can move it later if you desire.

- -

Starting the encode

- -

Select the Start button on the toolbar to make your new video.

- -

Main window toolbar

- -

Starting an encode

- -

HandBrake will report its progress while it’s working and alert you when it’s finished. Then you will have a new video file at the Destination you specified.

- -

Encoding complete alert

- -

Destination video file icon

- -

Congratulations! You just encoded your first video using HandBrake. It’s now ready to watch on your devices.

- -

Next steps

- -

If you didn’t get a video file as expected, encountered an error, or had some other trouble, you can continue reading to learn more about how HandBrake works or jump right to Getting help.

- -

Continue to (TODO: add link).

- -
- - diff --git a/docs/fonts/opensans-bold-1.10.woff b/docs/fonts/opensans-bold-1.10.woff deleted file mode 100755 index fb04318b..00000000 Binary files a/docs/fonts/opensans-bold-1.10.woff and /dev/null differ diff --git a/docs/fonts/opensans-bold-1.10.woff2 b/docs/fonts/opensans-bold-1.10.woff2 deleted file mode 100755 index 1887871f..00000000 Binary files a/docs/fonts/opensans-bold-1.10.woff2 and /dev/null differ diff --git a/docs/fonts/opensans-bolditalic-1.10.woff b/docs/fonts/opensans-bolditalic-1.10.woff deleted file mode 100755 index 61477616..00000000 Binary files a/docs/fonts/opensans-bolditalic-1.10.woff and /dev/null differ diff --git a/docs/fonts/opensans-bolditalic-1.10.woff2 b/docs/fonts/opensans-bolditalic-1.10.woff2 deleted file mode 100755 index 1c18b15c..00000000 Binary files a/docs/fonts/opensans-bolditalic-1.10.woff2 and /dev/null differ diff --git a/docs/fonts/opensans-italic-1.10.woff b/docs/fonts/opensans-italic-1.10.woff deleted file mode 100755 index e991a81f..00000000 Binary files a/docs/fonts/opensans-italic-1.10.woff and /dev/null differ diff --git a/docs/fonts/opensans-italic-1.10.woff2 b/docs/fonts/opensans-italic-1.10.woff2 deleted file mode 100755 index 5d0369bd..00000000 Binary files a/docs/fonts/opensans-italic-1.10.woff2 and /dev/null differ diff --git a/docs/fonts/opensans-regular-1.10.woff b/docs/fonts/opensans-regular-1.10.woff deleted file mode 100755 index a2672bc5..00000000 Binary files a/docs/fonts/opensans-regular-1.10.woff and /dev/null differ diff --git a/docs/fonts/opensans-regular-1.10.woff2 b/docs/fonts/opensans-regular-1.10.woff2 deleted file mode 100755 index cb5125ad..00000000 Binary files a/docs/fonts/opensans-regular-1.10.woff2 and /dev/null differ diff --git a/docs/fonts/ropasans-italic-1.002.woff b/docs/fonts/ropasans-italic-1.002.woff deleted file mode 100755 index 88ffdfba..00000000 Binary files a/docs/fonts/ropasans-italic-1.002.woff and /dev/null differ diff --git a/docs/fonts/ropasans-italic-1.002.woff2 b/docs/fonts/ropasans-italic-1.002.woff2 deleted file mode 100755 index 56fef599..00000000 Binary files a/docs/fonts/ropasans-italic-1.002.woff2 and /dev/null differ diff --git a/docs/fonts/ropasans-regular-1.002.woff b/docs/fonts/ropasans-regular-1.002.woff deleted file mode 100755 index aaf389e6..00000000 Binary files a/docs/fonts/ropasans-regular-1.002.woff and /dev/null differ diff --git a/docs/fonts/ropasans-regular-1.002.woff2 b/docs/fonts/ropasans-regular-1.002.woff2 deleted file mode 100755 index fcf74b08..00000000 Binary files a/docs/fonts/ropasans-regular-1.002.woff2 and /dev/null differ diff --git a/docs/license-summary.html b/docs/license-summary.html deleted file mode 100644 index 61b09713..00000000 --- a/docs/license-summary.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - - - - HandBrake Documentation - License Summary - - - -
- -

License Summary

- -

HandBrake Documentation (this work) is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License.

- -

The following is a human-readable summary of the license, and is not a substitute for the full legal license.

- -

You are free to:

- -

Share — copy and distribute the material in any medium or format for any purpose, even commercially

- -

Adapt — remix, transform, and build upon the material for any purpose, even commercially

- -

The licensor cannot revoke these freedoms as long as you follow the license terms.

- -

Under the following terms:

- -

Attribution — You must give appropriate credit1, provide a link to the license, and indicate if changes were made2. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.

- -

ShareAlike — If you remix, transform, or build upon the material, you must distribute your contributions under the same license3 as the original.

- -

No additional restrictions — You may not apply legal terms or technological measures4 that legally restrice others from doing anything the license permits.

-
-
-
    -
  1. -

    If supplied, you must provide the name of the creator and attribution parties, a copyright notice, a license notice, a disclaimer notice, and a link to the material. More info on attribution.↩

    2. -
  2. -

    You must indicate if you modified the material and retain an indication of previous modifications. More info on attribution.↩

    3. -
  3. -

    You may also use a license listed as compatible at creativecommons.org/compatiblelicenses.↩

    4. -
  4. -

    The license prohibits application of effective technological measures, defined with reference to Article 11 of the WIPO Copyright Treaty. More info on application of effective technological measures.↩

    5. -
-
- - -
- - diff --git a/docs/license.html b/docs/license.html deleted file mode 100644 index 4d1fb1ce..00000000 --- a/docs/license.html +++ /dev/null @@ -1,166 +0,0 @@ - - - - - - - HandBrake Documentation - License - - - -
- -

Creative Commons Attribution-ShareAlike 4.0 International Public License

- -

By exercising the Licensed Rights (defined below), You accept and agree to be bound by the terms and conditions of this Creative Commons Attribution-ShareAlike 4.0 International Public License (“Public License”). To the extent this Public License may be interpreted as a contract, You are granted the Licensed Rights in consideration of Your acceptance of these terms and conditions, and the Licensor grants You such rights in consideration of benefits the Licensor receives from making the Licensed Material available under these terms and conditions.

- -

Section 1 – Definitions.

- -
    -
  1. Adapted Material means material subject to Copyright and Similar Rights that is derived from or based upon the Licensed Material and in which the Licensed Material is translated, altered, arranged, transformed, or otherwise modified in a manner requiring permission under the Copyright and Similar Rights held by the Licensor. For purposes of this Public License, where the Licensed Material is a musical work, performance, or sound recording, Adapted Material is always produced where the Licensed Material is synched in timed relation with a moving image.
    2. -
  2. Adapter’s License means the license You apply to Your Copyright and Similar Rights in Your contributions to Adapted Material in accordance with the terms and conditions of this Public License.
    3. -
  3. BY-SA Compatible License means a license listed at creativecommons.org/compatiblelicenses, approved by Creative Commons as essentially the equivalent of this Public License.
    4. -
  4. Copyright and Similar Rights means copyright and/or similar rights closely related to copyright including, without limitation, performance, broadcast, sound recording, and Sui Generis Database Rights, without regard to how the rights are labeled or categorized. For purposes of this Public License, the rights specified in Section 2(b)(1)-(2) are not Copyright and Similar Rights.
    5. -
  5. Effective Technological Measures means those measures that, in the absence of proper authority, may not be circumvented under laws fulfilling obligations under Article 11 of the WIPO Copyright Treaty adopted on December 20, 1996, and/or similar international agreements.
    6. -
  6. Exceptions and Limitations means fair use, fair dealing, and/or any other exception or limitation to Copyright and Similar Rights that applies to Your use of the Licensed Material.
    7. -
  7. License Elements means the license attributes listed in the name of a Creative Commons Public License. The License Elements of this Public License are Attribution and ShareAlike.
    8. -
  8. Licensed Material means the artistic or literary work, database, or other material to which the Licensor applied this Public License.
    9. -
  9. Licensed Rights means the rights granted to You subject to the terms and conditions of this Public License, which are limited to all Copyright and Similar Rights that apply to Your use of the Licensed Material and that the Licensor has authority to license.
    10. -
  10. Licensor means the individual(s) or entity(ies) granting rights under this Public License.
    11. -
  11. Share means to provide material to the public by any means or process that requires permission under the Licensed Rights, such as reproduction, public display, public performance, distribution, dissemination, communication, or importation, and to make material available to the public including in ways that members of the public may access the material from a place and at a time individually chosen by them.
    12. -
  12. Sui Generis Database Rights means rights other than copyright resulting from Directive 96/9/EC of the European Parliament and of the Council of 11 March 1996 on the legal protection of databases, as amended and/or succeeded, as well as other essentially equivalent rights anywhere in the world.
    13. -
  13. You means the individual or entity exercising the Licensed Rights under this Public License. Your has a corresponding meaning.
    14. -
- - -

Section 2 – Scope.

- -
    -
  1. License grant. - -
      -
    1. Subject to the terms and conditions of this Public License, the Licensor hereby grants You a worldwide, royalty-free, non-sublicensable, non-exclusive, irrevocable license to exercise the Licensed Rights in the Licensed Material to: -
        -
      1. reproduce and Share the Licensed Material, in whole or in part; and
        2. -
      2. produce, reproduce, and Share Adapted Material.
        3. -
      2. -
    2. Exceptions and Limitations. For the avoidance of doubt, where Exceptions and Limitations apply to Your use, this Public License does not apply, and You do not need to comply with its terms and conditions.
      3. -
    3. Term. The term of this Public License is specified in Section 6(a).
      4. -
    4. Media and formats; technical modifications allowed. The Licensor authorizes You to exercise the Licensed Rights in all media and formats whether now known or hereafter created, and to make technical modifications necessary to do so. The Licensor waives and/or agrees not to assert any right or authority to forbid You from making technical modifications necessary to exercise the Licensed Rights, including technical modifications necessary to circumvent Effective Technological Measures. For purposes of this Public License, simply making modifications authorized by this Section 2(a)(4) never produces Adapted Material.
      5. -
    5. Downstream recipients. -
        -
      1. Offer from the Licensor – Licensed Material. Every recipient of the Licensed Material automatically receives an offer from the Licensor to exercise the Licensed Rights under the terms and conditions of this Public License.
        2. -
      2. Additional offer from the Licensor – Adapted Material. Every recipient of Adapted Material from You automatically receives an offer from the Licensor to exercise the Licensed Rights in the Adapted Material under the conditions of the Adapter’s License You apply.
        3. -
      3. No downstream restrictions. You may not offer or impose any additional or different terms or conditions on, or apply any Effective Technological Measures to, the Licensed Material if doing so restricts exercise of the Licensed Rights by any recipient of the Licensed Material.
        4. -
      6. -
    6. No endorsement. Nothing in this Public License constitutes or may be construed as permission to assert or imply that You are, or that Your use of the Licensed Material is, connected with, or sponsored, endorsed, or granted official status by, the Licensor or others designated to receive attribution as provided in Section 3(a)(1)(A)(i).
      7. -
    -
    2. -
  2. Other rights. - -
      -
    1. Moral rights, such as the right of integrity, are not licensed under this Public License, nor are publicity, privacy, and/or other similar personality rights; however, to the extent possible, the Licensor waives and/or agrees not to assert any such rights held by the Licensor to the limited extent necessary to allow You to exercise the Licensed Rights, but not otherwise.
      2. -
    2. Patent and trademark rights are not licensed under this Public License.
      3. -
    3. To the extent possible, the Licensor waives any right to collect royalties from You for the exercise of the Licensed Rights, whether directly or through a collecting society under any voluntary or waivable statutory or compulsory licensing scheme. In all other cases the Licensor expressly reserves any right to collect such royalties.
      4. -
    -
    3. -
- - -

Section 3 – License Conditions.

- -

Your exercise of the Licensed Rights is expressly made subject to the following conditions.

- -
    -
  1. Attribution. - -
      -
    1. If You Share the Licensed Material (including in modified form), You must: -
        -
      1. retain the following if it is supplied by the Licensor with the Licensed Material: -
          -
        1. identification of the creator(s) of the Licensed Material and any others designated to receive attribution, in any reasonable manner requested by the Licensor (including by pseudonym if designated);
          2. -
        2. a copyright notice;
          3. -
        3. a notice that refers to this Public License;
          4. -
        4. a notice that refers to the disclaimer of warranties;
          5. -
        5. a URI or hyperlink to the Licensed Material to the extent reasonably practicable;
          6. -
        -
        2. -
      2. indicate if You modified the Licensed Material and retain an indication of any previous modifications; and
        3. -
      3. indicate the Licensed Material is licensed under this Public License, and include the text of, or the URI or hyperlink to, this Public License.
        4. -
      2. -
    2. You may satisfy the conditions in Section 3(a)(1) in any reasonable manner based on the medium, means, and context in which You Share the Licensed Material. For example, it may be reasonable to satisfy the conditions by providing a URI or hyperlink to a resource that includes the required information.
      3. -
    3. If requested by the Licensor, You must remove any of the information required by Section 3(a)(1)(A) to the extent reasonably practicable.
      4. -
    -
    2. -
  2. ShareAlike.

    In addition to the conditions in Section 3(a), if You Share Adapted Material You produce, the following conditions also apply.

    - -
      -
    1. The Adapter’s License You apply must be a Creative Commons license with the same License Elements, this version or later, or a BY-SA Compatible License.
      2. -
    2. You must include the text of, or the URI or hyperlink to, the Adapter’s License You apply. You may satisfy this condition in any reasonable manner based on the medium, means, and context in which You Share Adapted Material.
      3. -
    3. You may not offer or impose any additional or different terms or conditions on, or apply any Effective Technological Measures to, Adapted Material that restrict exercise of the rights granted under the Adapter’s License You apply.
      4. -
    -
    3. -
- - -

Section 4 – Sui Generis Database Rights.

- -

Where the Licensed Rights include Sui Generis Database Rights that apply to Your use of the Licensed Material:

- -
    -
  1. for the avoidance of doubt, Section 2(a)(1) grants You the right to extract, reuse, reproduce, and Share all or a substantial portion of the contents of the database;
    2. -
  2. if You include all or a substantial portion of the database contents in a database in which You have Sui Generis Database Rights, then the database in which You have Sui Generis Database Rights (but not its individual contents) is Adapted Material, including for purposes of Section 3(b); and
    3. -
  3. You must comply with the conditions in Section 3(a) if You Share all or a substantial portion of the contents of the database.
    4. -
- - -

For the avoidance of doubt, this Section 4 supplements and does not replace Your obligations under this Public License where the Licensed Rights include other Copyright and Similar Rights.

- -

Section 5 – Disclaimer of Warranties and Limitation of Liability.

- -
    -
  1. Unless otherwise separately undertaken by the Licensor, to the extent possible, the Licensor offers the Licensed Material as-is and as-available, and makes no representations or warranties of any kind concerning the Licensed Material, whether express, implied, statutory, or other. This includes, without limitation, warranties of title, merchantability, fitness for a particular purpose, non-infringement, absence of latent or other defects, accuracy, or the presence or absence of errors, whether or not known or discoverable. Where disclaimers of warranties are not allowed in full or in part, this disclaimer may not apply to You.
    2. -
  2. To the extent possible, in no event will the Licensor be liable to You on any legal theory (including, without limitation, negligence) or otherwise for any direct, special, indirect, incidental, consequential, punitive, exemplary, or other losses, costs, expenses, or damages arising out of this Public License or use of the Licensed Material, even if the Licensor has been advised of the possibility of such losses, costs, expenses, or damages. Where a limitation of liability is not allowed in full or in part, this limitation may not apply to You.
    3. -
  3. The disclaimer of warranties and limitation of liability provided above shall be interpreted in a manner that, to the extent possible, most closely approximates an absolute disclaimer and waiver of all liability.
    4. -
- - -

Section 6 – Term and Termination.

- -
    -

  1. This Public License applies for the term of the Copyright and Similar Rights licensed here. However, if You fail to comply with this Public License, then Your rights under this Public License terminate automatically.

    2. -

  2. Where Your right to use the Licensed Material has terminated under Section 6(a), it reinstates:

    - -
      -
    1. automatically as of the date the violation is cured, provided it is cured within 30 days of Your discovery of the violation; or
      2. -
    2. upon express reinstatement by the Licensor. -For the avoidance of doubt, this Section 6(b) does not affect any right the Licensor may have to seek remedies for Your violations of this Public License.
      3. -
    -
    3. -
  3. For the avoidance of doubt, the Licensor may also offer the Licensed Material under separate terms or conditions or stop distributing the Licensed Material at any time; however, doing so will not terminate this Public License.
    4. -
  4. Sections 1, 5, 6, 7, and 8 survive termination of this Public License.
    5. -
- - -

Section 7 – Other Terms and Conditions.

- -
    -
  1. The Licensor shall not be bound by any additional or different terms or conditions communicated by You unless expressly agreed.
    2. -
  2. Any arrangements, understandings, or agreements regarding the Licensed Material not stated herein are separate from and independent of the terms and conditions of this Public License.
    3. -
- - -

Section 8 – Interpretation.

- -
    -
  1. For the avoidance of doubt, this Public License does not, and shall not be interpreted to, reduce, limit, restrict, or impose conditions on any use of the Licensed Material that could lawfully be made without permission under this Public License.
    2. -
  2. To the extent possible, if any provision of this Public License is deemed unenforceable, it shall be automatically reformed to the minimum extent necessary to make it enforceable. If the provision cannot be reformed, it shall be severed from this Public License without affecting the enforceability of the remaining terms and conditions.
    3. -
  3. No term or condition of this Public License will be waived and no failure to comply consented to unless expressly agreed to by the Licensor.
    4. -
  4. Nothing in this Public License constitutes or may be interpreted as a limitation upon, or waiver of, any privileges and immunities that apply to the Licensor or You, including from the legal processes of any jurisdiction or authority.
    5. -
- - -
- - diff --git a/docs/style/style.css b/docs/style/style.css deleted file mode 100644 index 31bd9c37..00000000 --- a/docs/style/style.css +++ /dev/null @@ -1,126 +0,0 @@ -/** - * Ropa Sans - * Copyright 2011 Botjo Nikoltchev - * SIL Open Font License 1.1 - * http://scripts.sil.org/OFL - */ -@font-face { - font-family: 'Ropa Sans'; - font-style: normal; - font-weight: 400; - src: local('Ropa Sans'), local('RopaSans-Regular'), url('../fonts/ropasans-regular-1.002.woff2') format('woff2'), url('../fonts/ropasans-regular-1.002.woff') format('woff'); -} -@font-face { - font-family: 'Ropa Sans'; - font-style: italic; - font-weight: 400; - src: local('Ropa Sans Italic'), local('RopaSans-Italic'), url('../fonts/ropasans-italic-1.002.woff2') format('woff2'), url('../fonts/ropasans-italic-1.002.woff') format('woff'); -} - -/** - * Open Sans - * Digitized data copyright 2010-2011 Google Corporation - * Apache License 2.0 - * http://www.apache.org/licenses/LICENSE-2.0.html - */ -@font-face { - font-family: 'Open Sans'; - font-style: normal; - font-weight: 400; - src: local('Open Sans'), local('OpenSans-Regular'), url('../fonts/opensans-regular-1.10.woff2') format('woff2'), url('../fonts/opensans-regular-1.10.woff') format('woff'); -} -@font-face { - font-family: 'Open Sans'; - font-style: normal; - font-weight: 700; - src: local('Open Sans'), local('OpenSans-Bold'), url('../fonts/opensans-bold-1.10.woff2') format('woff2'), url('../fonts/opensans-bold-1.10.woff') format('woff'); -} -@font-face { - font-family: 'Open Sans'; - font-style: italic; - font-weight: 400; - src: local('Open Sans Italic'), local('OpenSans-Italic'), url('../fonts/opensans-italic-1.10.woff2') format('woff2'), url('../fonts/opensans-italic-1.10.woff') format('woff'); -} -@font-face { - font-family: 'Open Sans'; - font-style: italic; - font-weight: 700; - src: local('Open Sans Bold Italic'), local('OpenSans-BoldItalic'), url('../fonts/opensans-bolditalic-1.10.woff2') format('woff2'), url('../fonts/opensans-bolditalic-1.10.woff') format('woff'); -} - -article.docs { - margin: 0 auto; - padding: 40px 150px; - max-width: 650px; - font-family: 'Open Sans'; - font-size: 15px; - line-height: 25px; -} - -article.docs h1, -article.docs h2, -article.docs h3, -article.docs h4, -article.docs h5, -article.docs h6 { - font-family: 'Ropa Sans'; - font-weight: 400; - text-rendering: geometricPrecision; - color: rgb(60,60,60); -} - -article.docs h1 { - font-size: 40px; - line-height: 1; - letter-spacing: -0.035em; -} - -article.docs h2 { - font-size: 28px; - line-height: 30px; - letter-spacing: -0.025em; -} - -article.docs h3 { - font-size: 21px; - line-height: 25px; - text-transform: uppercase; - letter-spacing: -0.018em; -} - -article.docs h4 { - font-size: 19px; - line-height: 20px; - letter-spacing: -0.02em; -} - -article.docs h5 { - font-size: 17px; - line-height: 20px; - text-transform: uppercase; - letter-spacing: -0.01em; -} - -article.docs h6 { - font-size: 14px; - line-height: 15px; - text-transform: uppercase; - letter-spacing: -0.005em; -} - -article.docs header .breadcrumbs { - font-size: 12px; -} - -article.docs footer p { - font-style: italic; -} - -article.docs p, -article.docs > ol, -article.docs > ul, -article.docs header .breadcrumbs, -article.docs footer p, -article.docs footer small { - margin: 1.33333em 0; -}