Reelhaus Support
Reelhaus is a Mac app for browsing and playing your own movie and TV show files with artwork, cast and watch progress. Need help? Check the answers below or contact us.
Frequently asked questions
Which files can I import?
MP4, M4V and MOV video files, with or without embedded metadata. Use File › Import Files (⌘I) or Import Directory (⇧⌘I), drag files or folders onto the Reelhaus window, or add a watched folder. See Metadata.
Does Reelhaus copy or change my videos?
No. Reelhaus reads your files where they are and never modifies them. The library stores metadata and artwork; the videos stay in their original location.
I moved or renamed a file and it no longer plays.
Reelhaus usually follows renamed or moved files on the same disk. Inside a watched folder, files that disappear are marked File missing; put the file back or remove the item in Settings › Folders › Remove from Library…. For files imported individually, remove the item and import it again from its new location.
My files are on an external drive or network share.
That works as long as the drive or share is connected and mounted when you play. If playback fails with error 1, reconnect the drive, then re-import the file.
I changed a file's metadata. How do I update it in Reelhaus?
Right-click the item and choose Update Metadata. To change title, show, season, episode, year, genres, description or artwork inside Reelhaus, choose Edit Metadata… (⌥⌘E); the video file is not modified.
What is "Continue Watching"?
The Home tab lists movies and episodes you stopped between about 5% and 95%, plus recently added items. Your position is saved every 10 seconds. Right-click an item and choose Remove from Continue Watching to hide it.
Can I watch my library on another device?
Reelhaus includes an optional local API for your own devices. See Local API.
Does Reelhaus collect my data?
No. There is no tracking, analytics or account. See the Privacy Policy.
Metadata
Reelhaus builds your library from the metadata embedded in each MP4/M4V/MOV file (the same tags the Apple TV app uses). Files without tags are imported too: Reelhaus reads the title, year, show, season and episode from the file and folder names, for example The Matrix (1999).mp4, Dark.S01E02.1080p.mp4, Friends 1x05.m4v or Dark/Season 1/Episode 2.mp4. You can fix anything afterwards with Edit Metadata…. For the richest library (cast, crew, descriptions) these tags are recommended:
| Item | Required tags |
|---|---|
| Movie | Media kind Movie, Title. Recommended: release date, genre, description, artwork, cast, director. |
| TV episode | Media kind TV Show, Title (episode name), TV show name / Artist, season number, episode number. Recommended: release date, description, artwork. |
To add or fix tags, use a metadata editor such as Subler (free). If Subler is installed, Reelhaus can open a file in it from the item's menu (Open in Subler). After editing, choose Update Metadata in Reelhaus.
Tip: genre icons are matched by name (Action, Comedy, Drama, Documentary, Sci-Fi, Thriller…). Custom genres are supported and shown with a generic icon.
Error codes
| Code | Meaning | What to do |
|---|---|---|
| #1 | Reelhaus could not reopen a media file (bookmark could not be resolved). | Make sure the drive or share is connected. If the file was moved, renamed or deleted, remove it from the library and import it again. |
| #2, #3 | Subler could not be opened. | Install or update Subler in your Applications folder, then try again. |
| #4 | The file could not be accessed during import. | Check that the file still exists and that your user can read it, then import it again. |
| #5 | No longer used (files with missing tags are imported using their file name). | — |
| #6 | Unknown error while reading the file. | Make sure the file plays in QuickTime Player. If it does, contact us with the error message. |
| #7 | No longer used (files without metadata are imported using their file name). | — |
| #8 | Access to the selected file was denied, or credits could not be built. | Select the file again with the Import dialog. If the problem persists, check the cast/crew tags of the file. |
| #9 | Access to the selected or dropped folder was denied. | Choose the folder again with Import Directory. |
| #10 | A file inside the selected folder could not be read. | Check the file's permissions, or import it individually. |
| #11 | A folder could not be added as a watched folder. | Check that the folder or drive is available and readable, then add it again in Settings › Folders. |
Watched folders and drag and drop
In Settings › Folders, click Add Folder…. Reelhaus imports the videos in that folder and its subfolders and then checks for new files automatically (while the app is open, when you return to it and every 15 minutes; Scan Now checks immediately). Reelhaus only reads watched folders: it never changes, moves or deletes your files. Items you remove from the library are not imported again. If a drive is disconnected, its folder is shown as unavailable and nothing is removed. Files that failed to import are listed under Problems.
You can also drag videos or whole folders onto the Reelhaus window to import them.
Subtitles (.srt, .vtt)
The built-in player shows external subtitle files. Name them like the video, optionally with a language code: Movie.srt, Movie.es.srt, Movie.en.vtt. They are found automatically when the video is in a watched folder. For videos imported individually, move the mouse over the player, open the subtitles menu (top right) and choose Choose Subtitle File…; Reelhaus remembers the file. The same menu turns subtitles on or off and switches language. Subtitles embedded in the video are available from the player's own subtitle button.
Local API (advanced)
Off by default. Turn it on in Settings › API. By default it only accepts connections from the same Mac; enable Allow connections from other devices to use it on your home network. Every request must include your access token (shown in Settings › API) as Authorization: Bearer <token> or ?token=<token>. Generate a new token at any time to revoke old clients. Only use it on networks you trust.
Contact
Email: jorgeealdunate@gmail.com. Please include your macOS version, Reelhaus version (Reelhaus › About Reelhaus) and any error code.
Español
Reelhaus es una app para Mac para explorar y reproducir tus propias películas y series con portadas, reparto y progreso. ¿Necesitas ayuda? Revisa estas respuestas o escríbenos.
Preguntas frecuentes
¿Qué archivos puedo importar?
Videos MP4, M4V y MOV, con o sin metadatos incrustados. Usa Archivo › Importar archivos (⌘I) o Importar carpeta (⇧⌘I), arrastra archivos o carpetas a la ventana de Reelhaus o agrega una carpeta vigilada. Ver Metadatos.
¿Reelhaus copia o modifica mis videos?
No. Reelhaus lee tus archivos donde están y nunca los modifica.
Moví o renombré un archivo y ya no se reproduce.
Reelhaus suele seguir los archivos renombrados o movidos dentro del mismo disco. En una carpeta vigilada, los archivos que desaparecen se marcan como Falta el archivo; devuélvelo a su lugar o quita el elemento en Ajustes › Carpetas › Quitar de la biblioteca…. Si lo importaste por separado, quítalo e impórtalo de nuevo desde su nueva ubicación.
Mis archivos están en un disco externo o carpeta de red.
Funciona mientras el disco o la carpeta compartida estén conectados. Si aparece el error 1, vuelve a conectarlos y reimporta el archivo.
Cambié los metadatos de un archivo. ¿Cómo los actualizo?
Haz clic derecho en el elemento y elige Actualizar metadatos. Para cambiar título, serie, temporada, episodio, año, géneros, descripción o portada dentro de Reelhaus, elige Editar metadatos… (⌥⌘E); el archivo de video no se modifica.
¿Qué es «Seguir viendo»?
La pestaña Inicio muestra las películas y episodios que dejaste entre aproximadamente el 5% y el 95%, y lo agregado recientemente. La posición se guarda cada 10 segundos. Haz clic derecho y elige Quitar de «Seguir viendo» para ocultar un elemento.
¿Reelhaus recopila mis datos?
No. No hay rastreo, analítica ni cuentas. Ver la Política de privacidad.
Metadatos
Reelhaus arma la biblioteca con los metadatos incrustados en cada MP4/M4V/MOV. Los archivos sin metadatos también se importan: el título, año, serie, temporada y episodio se leen del nombre del archivo y de la carpeta, por ejemplo The Matrix (1999).mp4, Dark.S01E02.1080p.mp4, Friends 1x05.m4v o Dark/Temporada 1/Episodio 2.mp4. Luego puedes corregir lo que quieras con Editar metadatos…. Para una biblioteca más completa (reparto, descripciones) puedes agregar metadatos con Subler (gratis) y usar Actualizar metadatos.
Códigos de error
| Código | Qué significa y qué hacer |
|---|---|
| #1 | No se pudo volver a abrir el archivo. Conecta el disco; si lo moviste o renombraste, reimpórtalo. |
| #2, #3 | No se pudo abrir Subler. Instálalo o actualízalo en Aplicaciones. |
| #4 | No se pudo acceder al archivo al importar. Verifica que exista y que puedas leerlo. |
| #5 | Ya no se usa (los archivos con metadatos incompletos se importan usando el nombre del archivo). |
| #6 | Error desconocido al leer el archivo. Comprueba que se reproduzca en QuickTime y escríbenos con el mensaje. |
| #7 | Ya no se usa (los archivos sin metadatos se importan usando el nombre del archivo). |
| #8 | Acceso denegado al archivo o no se pudieron generar los créditos. Vuelve a seleccionarlo o revisa los datos de reparto. |
| #9 | Acceso denegado a la carpeta elegida o arrastrada. Elígela de nuevo con Importar carpeta. |
| #10 | No se pudo leer un archivo de la carpeta. Revisa sus permisos o impórtalo por separado. |
| #11 | No se pudo agregar la carpeta como carpeta vigilada. Verifica que la carpeta o el disco estén disponibles y se puedan leer, y agrégala de nuevo en Ajustes › Carpetas. |
Carpetas vigiladas y arrastrar y soltar
En Ajustes › Carpetas, haz clic en Agregar carpeta…. Reelhaus importa los videos de esa carpeta y sus subcarpetas y luego revisa automáticamente si hay archivos nuevos (con la app abierta, al volver a ella y cada 15 minutos; Revisar ahora revisa al instante). Reelhaus solo lee las carpetas vigiladas: nunca cambia, mueve ni elimina tus archivos. Lo que quites de la biblioteca no se vuelve a importar. Si desconectas un disco, su carpeta aparece como no disponible y no se quita nada. Los archivos que no se pudieron importar aparecen en Problemas.
También puedes arrastrar videos o carpetas completas a la ventana de Reelhaus para importarlos.
Subtítulos (.srt, .vtt)
El reproductor integrado muestra subtítulos externos. Nómbralos igual que el video, opcionalmente con el código de idioma: Pelicula.srt, Pelicula.es.srt, Pelicula.en.vtt. Se encuentran solos cuando el video está en una carpeta vigilada. Si importaste el video por separado, mueve el mouse sobre el reproductor, abre el menú de subtítulos (arriba a la derecha) y elige Elegir archivo de subtítulos…; Reelhaus lo recuerda. El mismo menú activa o desactiva los subtítulos y cambia el idioma. Los subtítulos incrustados en el video están en el botón de subtítulos del propio reproductor.
API local (avanzado)
Viene desactivada. Actívala en Ajustes › API. Por defecto solo acepta conexiones desde el mismo Mac; activa Permitir conexiones desde otros dispositivos para usarla en tu red. Cada solicitud necesita tu token de acceso. Úsala solo en redes de confianza.
Contacto
Correo: jorgeealdunate@gmail.com. Incluye tu versión de macOS, la versión de Reelhaus y el código de error.