HamHub FAQ

What is HamHub Library

HamHub Library is HamHub's built-in cloud media organizer. Add a cloud storage account or file server first, then create a movie or TV library and add one or more folders to it. HamHub scans the video files in those folders, recognizes titles, years, seasons and episodes, fetches posters and metadata, then presents everything on the home page as poster walls and categorized lists.

Libraries can currently choose folders from 115 Life, Aliyun Drive, Baidu Netdisk, Guangya Cloud Drive, WebDAV, SMB/FTP/FTPS, Google Drive and more. One library can include folders from multiple sources, and you can select either a root folder or a subfolder; when a parent folder is selected, child folders are included automatically to avoid duplicate scans.

When creating a library, you can choose the media type, set a library name, configure the recognition language, and enable AI search when available to help identify file paths. HamHub triggers scans after folders are added or changed, and you can also rescan manually from the home page with live progress shown in the interface.

How to Join TF Beta Testing

Click the following links to join HamHub TF testing

1. iOS TF
2. tvOS TF
3. macOS TF

Why My File Path Is Not Recognized

As a newly launched video playback and management app, HamHub supports a wide range of video sources including Alist, Aliyun Drive, Baidu Netdisk, 115 Netdisk, Guangya Cloud Drive, SMB, WebDAV, FTP and FTPS, and is compatible with media servers like Emby and Jellyfin. To improve HamHub Library's efficiency and accuracy in organizing and displaying your media library, users need to follow a set of detailed file naming conventions. These rules help HamHub more accurately auto-generate poster walls and fetch media information.

Basic File Naming Guide

First, we strongly recommend creating a separate folder for each movie or TV series, rather than mixing them together, which is not conducive to scraping.

For folder naming, we suggest using the format: Title(Year), with parentheses in half-width (English input mode).

• Movie folder example: Interstellar(2014)
• TV series folder example: Breaking Bad(2008)

1. Movie Naming Rules:

   • Movie files should start with the complete title, optionally including both Chinese and English names, followed by the release year and important file information like resolution and encoding format.

   • Example: Interstellar(2014)/Interstellar.2014.720p.BluRay.x264.mp4

     Note: The part before / is the folder name

2. TV Series Naming Rules:

   • TV series files should first indicate the show name, followed by season and episode information in SXXEXX format, where XX represents season and episode numbers.

   • Example: Breaking Bad(2008)/Breaking.Bad.S01E01.2008.1080p.Netflix.WEB-DL.mkv

   • Or: Breaking Bad(2008)/Breaking.Bad.S01E01.mkv

     Note: The part before / is the folder name

   The most important part is the show name + S01E01, the rest doesn't matter much.

3. Specials & Extras:

   • Specials and extras should start with the original show name, with season number set to 00, followed by episode number (EXX) and content type.

   • Example: Game of Thrones(2011)/Game.of.Thrones.S00E01.Behind.the.Scenes.720p.HBO.mkv

     Note: The part before / is the folder name

Mac/iPad/tvOS Restore Purchase Not Working

• Please check if your App Store account is the same as the one used to purchase Ham Pro.
• If confirmed, due to Apple account data sync issues, you can try purchasing again.
• Re-purchasing won't charge you: Apple system restriction - purchasing the same item again won't trigger payment, but will update purchase data to restore your purchase information.

iCloud Not Syncing to Other Devices

Possible Causes and Solutions:

1. Account Issues

   • Ensure using the same iCloud account
   • Confirm all devices are logged into the same iCloud account to allow data sharing.

2. Sync Settings

   • Check iCloud sync toggle
   • In device system settings, ensure the iCloud sync toggle for the app is turned on.

3. Storage Space

   • Check iCloud storage space
   • If iCloud storage is insufficient, it may prevent data sync. Please check and clean up or upgrade storage.

4. Version Compatibility

   • Update client version
   • Ensure all apps that need to sync data are updated to the latest version to avoid compatibility issues.

5. Service Status

   • iCloud server sync may be slow or experiencing temporary issues.
   • Visit Apple System Status page to check if iCloud services are running normally.