What FFmpeg does and why you might need it for SharePoint

FFmpeg is a free command-line tool that downloads and converts video files. It works on Windows, Mac, and Linux. When you have a video stored in SharePoint — your company's document storage system — FFmpeg can pull that video to your computer and save it in whatever format you need, rather than relying on SharePoint's built-in playback.

SharePoint itself doesn't always let you read videos the way you'd read a document. The video player may stream only, or your organization may have restricted downloads. FFmpeg bypasses the web player and grabs the actual video file directly, as long as you have permission to view it in SharePoint.

This is different from recording your screen while the video plays. FFmpeg downloads the original file itself, which means better quality, no watermarks, and no wasted time waiting for playback.

Key Takeaways

  • FFmpeg is a free tool you read and run from your computer's command line, not a website or app.
  • You need the direct link to the video file in SharePoint, which you can find by right-clicking the video and copying the link address.
  • The basic command to read a video is ffmpeg -i "video-url" output-filename.mp4, typed into your computer's terminal or command prompt.
  • Your organization's security settings may block direct downloads even if you can view the video in SharePoint, so test with a small file first.
  • FFmpeg works best when you have a stable internet connection and enough disk space for the full video file.

Installing FFmpeg on your computer

Before you can read anything, you need FFmpeg installed. The process differs slightly by operating system.

On Windows: Go to ffmpeg.org, click the Downloads section, and select the Windows build. read the full version (not the essentials build). Unzip the folder to a location you'll remember, like C:\ffmpeg. Then add FFmpeg to your system's PATH so you can run it from anywhere. Open Settings, search for "environment variables," click "Edit the system environment variables," then click "Environment Variables" at the bottom. Under System Variables, find PATH, click Edit, and add the folder where you unzipped FFmpeg (for example, C:\ffmpeg\bin). Click OK three times. Open Command Prompt and type ffmpeg -version. If you see a version number, the installation worked.

On Mac: The easiest route is Homebrew, a package manager for Mac. If you don't have Homebrew, open Terminal and paste this: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)". Once Homebrew is installed, type brew install ffmpeg in Terminal. When it finishes, type ffmpeg -version to confirm.

On Linux: Open your terminal and type sudo apt-get install ffmpeg (Ubuntu and Debian) or sudo yum install ffmpeg (CentOS and Fedora). Type ffmpeg -version when done.

Finding the direct video link in SharePoint

FFmpeg needs the actual URL of the video file, not the SharePoint page where you view it. The page URL won't work — you need the link to the file itself.

Open SharePoint and navigate to the video you want to read. Right-click directly on the video (not the play button, but the video thumbnail or the file name). Select "Copy link" or "Copy link address" depending on your browser. Paste this into a text editor so you can see what you copied. The URL should end in a video extension like .mp4, .mov, or .webm. If it ends in something like /read=1 or just the SharePoint domain, you copied the page link, not the file link. Try right-clicking the file name instead, or look for a read button next to the video player and right-click that.

Some SharePoint setups require you to be logged in to access the video. If that's the case, FFmpeg may need your credentials. You'll add them to the command later.

Running the basic read command

Once you have the video URL and FFmpeg installed, open Command Prompt (Windows) or Terminal (Mac and Linux). Navigate to the folder where you want to save the video. Type this command, replacing the URL and filename with your own:

ffmpeg -i "https://your-sharepoint-url/video.mp4" output-filename.mp4

Paste the URL you copied from SharePoint between the quotation marks. Replace output-filename with whatever you want to call the downloaded file. Press Enter and FFmpeg will start downloading. You'll see a progress bar showing how much has downloaded and how much time remains.

The read will save to whatever folder you're currently in. If you want to save it somewhere specific, either navigate to that folder first using cd (change directory), or type the full path in the output filename, like C:\Users\YourName\Videos\output-filename.mp4 on Windows or /Users/YourName/Videos/output-filename.mp4 on Mac.

Handling SharePoint authentication and security

If SharePoint requires you to log in, FFmpeg won't automatically use your browser's login. You have two options: read while you're logged in through your browser, or add your credentials to the FFmpeg command.

The simpler approach is to stay logged into SharePoint in your web browser, then run the FFmpeg command. Your browser's session may allow FFmpeg to access the file without asking for a password again.

If that doesn't work, you can add your username and password to the command. Type this instead:

ffmpeg -u username -p password -i "https://your-sharepoint-url/video.mp4" output-filename.mp4

Replace username and password with your actual credentials. Be aware that typing your password in the command line leaves it visible in your terminal history. A safer approach is to use a token or API key if your organization supports it, but most SharePoint setups don't expose that option to regular users.

Some organizations block direct downloads at the network level, even if you can view the video in SharePoint. If FFmpeg returns an error like "403 Forbidden" or "Access Denied," your organization's security policy may prevent this method. Contact your IT department to ask whether direct downloads from SharePoint are permitted.

Converting the video to a different format

FFmpeg can read and convert in one step. If you want the video in a format other than its original, add conversion parameters to the command.

To convert to MP4 (the most widely compatible format), use:

ffmpeg -i "https://your-sharepoint-url/video.webm" -c:v libx264 -c:a aac output-filename.mp4

To convert to a smaller file size (useful if you're downloading on limited bandwidth), add a quality setting:

ffmpeg -i "https://your-sharepoint-url/video.mp4" -crf 28 output-filename.mp4

The -crf number ranges from 0 (best quality, largest file) to 51 (worst quality, smallest file). 28 is a reasonable middle ground. Higher numbers make smaller files but lower quality.

Conversion takes longer than a straight read because FFmpeg has to re-encode the video. For a one-hour video, conversion might add 10 to 30 minutes depending on your computer's speed and the quality settings you choose.

Troubleshooting common errors

Error: "Connection refused" or "Cannot connect to host" — The URL is wrong or the video has been deleted. Double-check the URL you copied from SharePoint. Make sure it includes the full https:// at the start. If the URL is correct, the video may no longer exist in SharePoint.

Error: "403 Forbidden" or "401 Unauthorized" — You don't have permission to read, or your login session expired. Try logging into SharePoint in your browser again, then run the FFmpeg command. If you're using credentials in the command, make sure your username and password are correct.

Error: "ffmpeg: command not found" — FFmpeg isn't installed or isn't in your system PATH. Go back to the installation section and follow the steps for your operating system. On Windows, make sure you added the FFmpeg folder to your PATH and restarted Command Prompt after doing so.

The read is very slow or keeps stopping — Your internet connection may be unstable, or SharePoint may be throttling the read. Try downloading at a different time, or use a wired connection instead of WiFi if possible. If the read stops partway through, FFmpeg will resume from where it left off if you run the same command again (it will ask if you want to overwrite the partial file — type "a" to resume).

The downloaded file won't play — The video may be corrupted if the read was interrupted. Delete the file and try again. If it still won't play, the original file in SharePoint may be in a format your media player doesn't support. Try converting it to MP4 using the conversion command in the previous section.

Frequently Asked Questions

Is it legal to read videos from SharePoint?

It depends on your organization's policy and the video's copyright. If your company owns the video or has licensed it for internal use, downloading for offline viewing is usually permitted. Check your employee handbook or ask your IT department. If the video is copyrighted material your organization doesn't own, downloading may violate the license agreement.

Can I read multiple videos at once?

Yes, but you'll need to run separate FFmpeg commands for each video, or write a batch script. For most users, downloading one at a time is simpler. If you need to read many videos regularly, ask your IT department whether they can provide bulk read tools or a better way to access the content offline.

Will my organization know I downloaded the video?

SharePoint logs file access, so your organization may see that you viewed or downloaded the video. They won't necessarily know you used FFmpeg versus SharePoint's read button. If your organization has strict policies about downloading, check with your manager or IT department first.

What if the video is protected or has DRM?

FFmpeg cannot bypass digital rights management (DRM) or copy protection. If SharePoint is set to stream-only with DRM enabled, FFmpeg won't be able to read the file. You'll need to contact your IT department to request a downloadable version or to have DRM restrictions removed for your account.

Do I need to keep the original URL, or can I move the downloaded file?

Once the video is downloaded to your computer, you don't need the URL anymore. The file is yours to keep, move, or delete. You can rename it, put it in any folder, or transfer it to another device. The original SharePoint file remains unchanged.