Video Upload
Skatehive provides free video upload and transcoding for all skate content. Videos are transcoded to web-optimized formats and stored on IPFS for permanent access.
π¬ Overviewβ
When you upload a video:
- Video is sent to a transcoding server
- Server converts it to web-optimized format
- Transcoded video is uploaded to IPFS
- You receive an IPFS URL to use in your post
The service is completely free for Skatehive community members.
π₯οΈ Transcoding Serversβ
Skatehive runs multiple transcoding servers with automatic fallback:
| Priority | Server | Location |
|---|---|---|
| 1 | Oracle Cloud | Primary (146.235.239.243) |
| 2 | Mac Mini M4 | Secondary (192.168.68.57) |
| 3 | Raspberry Pi | Tertiary (192.168.68.105) |
If the primary server is unavailable, the system automatically tries the next one.
π€ How It Worksβ
Webapp Uploadβ
- Open the post composer
- Click the video upload button
- Select your video file
- Wait for transcoding and IPFS upload
- Video URL is inserted into your post
Mobile App Uploadβ
- Record or select a video
- The app checks server status via the API
- Video is sent to the active transcoding server
- Progress is shown during upload
- IPFS URL is returned and used in your post
π Upload Detailsβ
When uploading, the following data is sent:
| Field | Description |
|---|---|
video | The video file |
username | Your Hive username |
deviceInfo | Device type (webapp/mobile) |
browser | Browser information (webapp) |
isIOS | iOS flag for mobile |
isAndroid | Android flag for mobile |
screenWidth | Screen width |
screenHeight | Screen height |
Device info helps with debugging and optimization.
π§ Server Status APIβ
The mobile app uses a status endpoint to get the active server:
GET https://api.skatehive.app/api/v1/status
Response includes the current active transcoding URL.
π Supported Formatsβ
Input Formatsβ
- MP4, MOV, AVI, MKV
- Most common video codecs
- Max file size: ~500MB (recommended)
Output Formatβ
- MP4 with H.264 codec
- Web-optimized for streaming
- Compressed for fast loading
π IPFS Storageβ
After transcoding, videos are stored on IPFS:
- Gateway:
ipfs.skatehive.app - Pinning: Via Pinata for permanence
- Access: Videos remain available as long as they're pinned
Video URLs look like:
https://ipfs.skatehive.app/ipfs/Qm...
β±οΈ Processing Timeβ
Processing time depends on:
- Video length
- Original file size
- Server load
- Your connection speed
Typical times:
- 30-second clip: ~1-2 minutes
- 3-minute video: ~5-10 minutes
- Longer videos: 15+ minutes
π‘ Tips for Best Resultsβ
- Trim before upload - Remove unnecessary footage
- Use good lighting - Better input = better output
- Horizontal preferred - Standard 16:9 works best
- Check connection - Stable internet prevents failures
- Be patient - Large videos take time
β οΈ Troubleshootingβ
Upload Failedβ
- Check your internet connection
- Try a smaller file
- Wait and retry (server may be busy)
Video Won't Playβ
- Wait for transcoding to complete
- Check the IPFS URL is correct
- Try a different browser
Slow Processingβ
- Large files take longer
- Peak times may be slower
- System auto-retries if needed
π Technical Flowβ
Video File
β
Transcoding Server (Oracle/Mac Mini/RPi)
β
FFmpeg Processing (H.264 conversion)
β
IPFS Upload (Pinata)
β
IPFS URL Returned
β
Embedded in Hive Post
Upload your skate clips and share them forever on the blockchain! π¬πΉ