thePR0M3TH3AN/bitvid
1
0 Fork 0
mirror of https://github.com/PR0M3TH3AN/bitvid.git synced 2026-10-27 07:52:24 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #2280 from PR0M3TH3AN/update-upload-docs-17963360573504553871

Browse Source 
🌐 Align /content user docs with actual upload & contribution behavior
This commit is contained in:
thePR0M3TH3AN authored and GitHub committed 2026-02-09 21:55:55 -05:00
2 parents b6294e8e46 34f2f63783
commit ef84ed66de
1 file changed
+9 -3
Download Patch File Download Diff File Expand all files Collapse all files
content/docs/guides/upload-content.md
+9 -3
View File
@@ -15,7 +15,7 @@ bitvid offers three ways to publish content:
Before you start, ensure your content meets the following requirements:
### Accepted File Types
- **Video:** `.mp4`, `.webm`, `.mov`, `.mkv`, `.ts`, `.m3u8`, `.mpg`, `.mpeg`.
- **Video:** `.mp4` (`video/mp4`), `.webm` (`video/webm`), `.mov` (`video/quicktime`), `.mkv` (`video/x-matroska`), `.ts` (`video/mp2t`), `.m3u8` (`application/x-mpegurl`), `.mpg` (`video/mpeg`), `.mpeg` (`video/mpeg`).
- **Thumbnail:** Any standard image format (`image/*`) supported by your browser.
> **Note:** The file picker restricts selection to these formats, but the backend handles standard video MIME types (`video/*`). Ensure your container format is supported by modern browsers for playback.
@@ -45,6 +45,10 @@ For power users and technical configurations:
- **Duration:** Manually specify the video duration in seconds.
- **Summary:** A short summary separate from the full description.
- **IMETA (Video Variants):** Define alternative video sources, resolutions, or MIME types.
- **MIME:** (e.g., `video/mp4`)
- **Dimensions:** (e.g., `1920x1080`)
- **URL:** Direct link to the video file
- **Magnet:** Info hash or magnet link
- **Web Seed (ws):** Manually provide a web seed URL for the torrent.
- **Torrent File (xs):** Manually provide a URL to a `.torrent` file.
@@ -74,7 +78,7 @@ bitvid will attempt to configure CORS automatically if your API keys have "Admin
[
{
"AllowedOrigins": ["http://localhost:5500", "https://bitvid.network"],
"AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD", "OPTIONS"],
"AllowedMethods": ["GET", "HEAD", "PUT", "POST", "DELETE", "OPTIONS"],
"AllowedHeaders": ["*"],
"ExposeHeaders": ["ETag", "Content-Length", "Content-Range", "Accept-Ranges"],
"MaxAgeSeconds": 3600
@@ -117,7 +121,9 @@ bitvid will verify your credentials by attempting to list or upload a test file.
### Common Issues
- **CORS Errors ("Network Error"):** If uploads fail immediately or the console shows "CORS", verify your bucket's CORS policy matches the JSON above. Ensure `AllowedHeaders` includes `*` and `ExposeHeaders` lists `ETag`.
- **Missing Title:** A title is required to publish a video.
- **Missing Source:** You must provide a hosted URL, magnet link, or upload a file.
- **CORS Errors ("Network Error"):** If uploads fail immediately or the console shows "CORS", verify your bucket's CORS policy matches the JSON above. Ensure `AllowedHeaders` includes `*`, `AllowedMethods` includes `PUT`, and `ExposeHeaders` lists `ETag`.
- **Permission Errors ("Access Denied"):** Check your API credentials. Ensure the token has `Object Read & Write` permissions (specifically `s3:PutObject` and `s3:DeleteObject`).
- **Browser Crashes / Slow Performance:** Large files (>2GB) can exhaust browser memory during the hashing process. Try using a smaller file or ensuring you have plenty of free RAM.
- **Playback Issues:** If the video uploads but doesn't play, ensure the "Public Access URL" is correct and publicly reachable. Test the URL directly in a browser.