문제 해결

이 가이드에서는 FloSync 사용 중 겪을 수 있는 일반적인 문제와 해결 방법을 다룹니다. 여기에 해당하는 문제가 없다면 FAQ를 확인하거나 지원팀에 문의하세요.

진단 로그

FloSync는 문제 진단에 유용한 상세 로그를 기록합니다. 동기화 문제를 추적하거나, 세션 중 발생한 상황을 파악하거나, 지원팀에 문의할 때 큰 도움이 됩니다.

로그 접근 방법

메뉴에서:

macOS: 도움말 > 로그 폴더 열기
Windows: 도움말 > 로그 폴더 열기

수동 경로:

macOS: ~/Library/Application Support/FloSync/logs/
Windows: %APPDATA%/FloSync/logs/

로그 구조

로그는 날짜와 시간별로 정리됩니다:

logs/
├── 2026-01-19/
│   ├── 00.log    (자정~오전 1시)
│   ├── 01.log    (오전 1시~2시)
│   ├── ...
│   └── 23.log    (오후 11시~자정)
├── 2026-01-18/
│   └── ...

로그 보관

로그는 7일간 보관되며, FloSync 실행 시 자동으로 정리됩니다. 디스크 공간을 과도하게 쓰지 않으면서 문제 해결에 충분한 이력을 유지합니다.

로그에 기록되는 내용

로그에는 다음 항목이 타임스탬프와 함께 기록됩니다:

앱 시작 및 종료
영상 로딩 및 재생 이벤트
동기화 이벤트 및 보정
네트워크 동기화 연결 및 해제
예약 재생 중 씬 전환
오류 및 경고

로그를 이용한 문제 해결

문제 재현: 문제가 발생한 대략적인 시간을 기록합니다
로그 폴더 열기: 도움말 > 로그 폴더 열기를 사용합니다
해당 파일 찾기: 날짜 폴더로 이동하여 해당 시간대의 로그 파일을 엽니다
오류 검색: "ERROR" 또는 "WARN"으로 표시된 항목을 찾습니다
전후 맥락 확인: 오류 전후의 항목을 읽어 원인을 파악합니다

지원팀에 문의할 때 관련 로그 파일을 함께 보내면 문제를 더 빠르게 진단할 수 있습니다.

콘텐츠 로딩 문제

이미지가 로드되지 않음

증상: 이미지를 FloSync으로 드래그해도 반응이 없거나 오류가 나타납니다.

가능한 원인 및 해결 방법:

지원되지 않는 형식
- 지원 형식: PNG, JPG/JPEG, GIF, BMP, TIFF, WebP, SVG
- 다른 이미지 뷰어에서 열어 파일이 손상되지 않았는지 확인하세요
파일 권한
- 이미지 파일에 대한 읽기 권한이 있는지 확인하세요
- 네트워크 공유에 있다면 로컬 드라이브로 복사해 보세요
SVG 제한사항
- 일부 복잡한 SVG 기능은 제대로 렌더링되지 않을 수 있습니다
- SVG가 올바르게 표시되지 않으면 PNG로 변환해 보세요

웹 페이지가 로드되지 않음

증상: 화면에 빈 화면이 표시되거나 오류가 나타납니다.

가능한 원인 및 해결 방법:

HTTP vs HTTPS
- HTTPS URL만 지원됩니다 (HTTP 미지원)
- URL이 https://로 시작하는지 확인하세요
네트워크 연결
- 인터넷에 접속 가능한지 확인하세요
- 일반 브라우저에서 해당 사이트에 접속할 수 있는지 확인하세요
웹사이트의 임베딩 차단
- 일부 웹사이트는 WebView 포함을 차단합니다
- 다른 사이트를 시도하거나 로컬 HTML 파일을 대신 사용하세요

영상 재생 문제

영상이 로드되지 않음

증상: 영상을 FloSync으로 드래그해도 반응이 없거나 오류가 나타납니다.

가능한 원인 및 해결 방법:

지원되지 않는 형식
- MP4 (H.264)로 변환해 보세요. 아래 영상 코덱 권장사항을 참조하세요
- 다른 영상 플레이어에서 재생하여 파일이 손상되지 않았는지 확인하세요
코덱 누락
- FloSync에는 대부분의 일반 코덱이 포함되어 있지만, 일부 독점 형식은 지원되지 않을 수 있습니다
- MP4 같은 표준 형식으로 변환하세요
파일 권한
- 영상 파일에 대한 읽기 권한이 있는지 확인하세요
- 네트워크 공유에 있다면 로컬 드라이브로 복사해 보세요

영상이 끊기거나 프레임이 누락됨

증상: 재생이 불안정하거나 부드럽지 않습니다.

해결 방법:

CPU/GPU 사용량 확인: 한계에 도달했다면 하드웨어가 해당 해상도를 감당하지 못하는 것일 수 있습니다
SSD 저장 장치 사용: HDD는 고비트레이트 영상을 충분히 빠르게 읽지 못할 수 있습니다
영상 해상도 낮추기: 하드웨어가 부족하면 더 낮은 해상도로 재인코딩하세요
다른 앱 종료로 시스템 리소스를 확보하세요
동기화 허용 오차 확인: 동기화를 사용 중이라면 허용 오차를 높여 보정 횟수를 줄이세요

화면 문제

두 번째 화면이 감지되지 않음

증상: 여러 화면이 연결되어 있는데 FloSync에 하나만 표시됩니다.

해결 방법:

OS 디스플레이 설정 확인
- macOS: 시스템 설정 > 디스플레이
- Windows: 설정 > 시스템 > 디스플레이
- OS에서 모든 화면이 감지되는지 확인하세요
케이블 연결 확인
- 다른 케이블 시도
- 컴퓨터의 다른 포트 시도
새 화면 연결 후 FloSync 재시작
- FloSync는 실행 시점에 화면을 감지합니다

화면 배열이 일치하지 않음

증상: 스팬 모드에서 영상 섹션이 잘못된 화면에 표시됩니다.

해결 방법:

OS 화면 배열 설정
- macOS: 시스템 설정 > 디스플레이 > 배열
- Windows: 설정 > 시스템 > 디스플레이 (드래그하여 배열)
- 가상 배열을 실제 물리적 배치와 일치시키세요
배열 변경 후 FloSync 재시작

동기화 문제

화면이 동기화되지 않음 (로컬)

증상: 미러 또는 스팬 모드에서 화면마다 서로 다른 프레임이 표시됩니다.

해결 방법:

자동 보정 대기: FloSync가 지속적인 차이를 자동으로 보정합니다
상태 바 확인: 라이브 모드 중 동기화 보정 카운터가 보정 횟수를 표시합니다:
- 장시간 세션에서 낮은 수치는 정상입니다
- 반복적이거나 급격히 증가하는 수치는 설정 문제를 나타낼 수 있습니다
동기화 허용 오차 축소: 환경설정에서 허용 오차를 줄이세요
동기화 로그 확인: 동기화 경고와 보정 기록을 검토하세요
재생 재시작: 일시 정지 후 다시 재생하세요

네트워크 동기화가 작동하지 않음

증상: 클라이언트가 서버를 찾지 못하거나, 연결 후에도 동기화가 안 됩니다.

해결 방법:

같은 네트워크 확인
- 두 컴퓨터가 같은 로컬 네트워크에 있어야 합니다
- 컴퓨터 간 핑으로 확인하세요
같은 영상 파일
- 클라이언트에도 동일한 영상이 로드되어 있어야 합니다
- 영상 길이가 다르면 동기화가 실패합니다
방화벽 확인
- 양쪽 컴퓨터에서 방화벽을 통해 FloSync를 허용하세요
- UDP 포트 9201을 허용하세요
서버 실행 확인
- 상단 바에서 서버 아이콘(타워)이 녹색인지 확인하세요
- 상태 바에 "서버 모드"가 표시되는지 확인하세요
- 아이콘을 클릭하여 서버 모드를 중지했다가 다시 시작해 보세요
초기 안정화 대기
- 네트워크 동기화는 연결 직후 잠시 안정화 시간이 필요할 수 있습니다
- 초기 보정은 정상입니다
- 안정화 후에는 재생이 안정적이고 시각적으로 정렬된 상태를 유지해야 합니다

수일 운영 후 점진적 동기화 오차

증상: 네트워크 동기화가 정상 작동하다가 수일간 연속 운영 후 클라이언트가 지속적으로 50~100ms 차이를 보이며 완전히 자동 보정되지 않습니다.

원인: 모든 컴퓨터의 시스템 시계는 하드웨어 특성과 온도 차이로 인해 조금씩 다른 속도로 흐릅니다. 며칠간 중단 없이 가동하면 이 누적 오차가 실시간 보정으로 감당할 수 있는 범위를 초과할 수 있습니다. 이는 FloSync에 국한된 문제가 아니라, 시계 기반 동기화 시스템 전반에 해당됩니다.

해결 방법: 양쪽 컴퓨터를 재시작하세요. 무인 설치의 경우 비운영 시간에 매일 재시작을 예약하세요. 정기 재시작 예약을 참조하세요.

동기화 보정으로 인한 끊김

증상: 재생 중 영상이 자주 점프하거나 끊깁니다.

해결 방법:

환경설정에서 동기화 허용 오차를 높이세요
네트워크 품질을 확인하세요 (네트워크 동기화의 경우)
시스템 부하를 줄이세요. 불필요한 앱을 종료하세요
동기화 로그를 확인해 패턴을 파악하세요

라이브 시작 문제

전체 화면 창이 나타나지 않음

증상: 라이브 시작을 클릭해도 화면에 전체 화면 창이 생성되지 않습니다.

해결 방법:

화면 감지 확인
- 화면이 감지되었는지 확인하세요 (화면 배열 영역에 표시되어야 합니다)
- 화면을 분리했다가 다시 연결해 보세요
- 새 화면 연결 후 FloSync를 재시작하세요
영상 로딩 확인
- 라이브 시작 전에 최소 하나의 영상이 로드되어 있는지 확인하세요
- 영상 누락 표시가 있는지 확인하세요
권한 확인
- macOS: FloSync에 접근성 권한을 허용하세요 (시스템 설정 > 개인 정보 보호 및 보안 > 손쉬운 사용)
- Windows: 관리자 권한으로 FloSync를 실행해 보세요

ESC 키로 라이브 모드가 종료되지 않음

증상: 전체 화면 창에서 ESC를 눌러도 라이브 모드가 종료되지 않습니다.

해결 방법:

창에 포커스가 있는지 확인: 전체 화면 창을 먼저 클릭하세요
라이브 중지 버튼 사용: 제어판으로 돌아가서 "라이브 중지"를 클릭하세요
필요시 강제 종료: 최후 수단으로 Cmd+Q (macOS) 또는 Alt+F4 (Windows)를 사용하세요

앱 문제

FloSync이 시작되지 않음

macOS 해결 방법:

보안 설정
- FloSync를 우클릭하고 "열기"를 선택하세요
- 또는: 시스템 설정 > 개인 정보 보호 및 보안에서 FloSync를 허용하세요
환경설정 초기화
- 삭제: ~/Library/Application Support/com.tentekio.flosync/
- FloSync를 다시 실행하세요

Windows 해결 방법:

관리자 권한으로 실행
- FloSync를 우클릭 > 관리자 권한으로 실행
환경설정 초기화
- 삭제: %APPDATA%\Tentekio\FloSync\
- FloSync를 다시 실행하세요
Visual C++ 재배포 가능 패키지 재설치
- Microsoft에서 최신 버전을 다운로드하세요

높은 CPU/메모리 사용량

증상: FloSync가 과도한 시스템 리소스를 사용합니다.

해결 방법:

정상 범위 확인: 영상 재생은 본래 상당한 시스템 리소스가 필요합니다
영상 해상도 낮추기: 부담이 되면 4K 대신 1080p를 사용하세요
동시 영상 수 줄이기: 독립 모드에서
동기화 로그 패널 닫기: 로깅에도 일부 리소스가 사용됩니다
비정상 프로세스 확인: 영상을 중지해도 리소스 사용량이 줄지 않으면 FloSync를 재시작하세요

영상 코덱 문제

네트워크 동기화 사용 시 동기화 드리프트나 불안정한 재생이 발생하면, 영상 코덱이 원인일 수 있습니다.

빠른 해결: 최적의 동기화 성능을 원한다면 영상을 H.264 All-Intra로 트랜스코딩하세요. ProRes LT(macOS) 또는 DNxHD(Windows)도 지원되는 대안입니다.

영상 포맷, 권장 코덱, 테스트용 샘플 파일, FFmpeg 트랜스코딩 명령에 대한 자세한 내용은 영상 준비 가이드를 참조하세요.

알려진 제한사항

현재 제한사항

스팬 모드에서 베젤 경계가 완벽하게 정렬되지 않을 수 있습니다
WiFi 네트워크 동기화는 유선보다 안정성이 떨어집니다
일부 DRM 보호 콘텐츠는 재생할 수 없습니다
매우 높은 해상도의 영상 (8K 이상)은 모든 하드웨어에서 원활하지 않을 수 있습니다
라이브 모드 중에는 화면 모드를 변경할 수 없습니다 (라이브를 먼저 종료하세요)
웹 페이지는 화면 간 스패닝이 불가합니다 (스팬 모드에서 미러링으로 표시됨)
웹 페이지는 HTTPS URL만 지원됩니다 (HTTP 미지원)
네트워크 동기화는 영상 콘텐츠에서만 작동합니다 (이미지와 웹 페이지는 동기화 대상이 아님)

최적 성능을 위한 팁

네트워크 동기화에는 유선 연결을 사용하세요
콘텐츠 파일은 로컬 저장 장치에 보관하세요 (네트워크 드라이브 사용 지양)
세션 간에 화면 구성을 일관되게 유지하세요
중요한 프레젠테이션 전에 설정을 테스트하세요
스케줄링을 사용할 때는 짧은 씬으로 전환을 먼저 테스트하세요

문제 해결

진단 로그

로그 접근 방법

로그 구조

로그 보관

로그에 기록되는 내용

로그를 이용한 문제 해결

콘텐츠 로딩 문제

이미지가 로드되지 않음

웹 페이지가 로드되지 않음

영상 재생 문제

영상이 로드되지 않음

영상이 끊기거나 프레임이 누락됨

화면 문제

두 번째 화면이 감지되지 않음

화면 배열이 일치하지 않음

동기화 문제

화면이 동기화되지 않음 (로컬)

네트워크 동기화가 작동하지 않음

수일 운영 후 점진적 동기화 오차

동기화 보정으로 인한 끊김

라이브 시작 문제

전체 화면 창이 나타나지 않음

ESC 키로 라이브 모드가 종료되지 않음

앱 문제

FloSync이 시작되지 않음

높은 CPU/메모리 사용량

영상 코덱 문제

알려진 제한사항

현재 제한사항

최적 성능을 위한 팁

필수 쿠키

분석 쿠키

마케팅 쿠키

문제 해결

진단 로그 #

로그 접근 방법 #

로그 구조 #

로그 보관 #

로그에 기록되는 내용 #

로그를 이용한 문제 해결 #

콘텐츠 로딩 문제 #

이미지가 로드되지 않음 #

웹 페이지가 로드되지 않음 #

영상 재생 문제 #

영상이 로드되지 않음 #

영상이 끊기거나 프레임이 누락됨 #

화면 문제 #

두 번째 화면이 감지되지 않음 #

화면 배열이 일치하지 않음 #

동기화 문제 #

화면이 동기화되지 않음 (로컬) #

네트워크 동기화가 작동하지 않음 #

수일 운영 후 점진적 동기화 오차 #

동기화 보정으로 인한 끊김 #

라이브 시작 문제 #

전체 화면 창이 나타나지 않음 #

ESC 키로 라이브 모드가 종료되지 않음 #

앱 문제 #

FloSync이 시작되지 않음 #

높은 CPU/메모리 사용량 #

영상 코덱 문제 #

알려진 제한사항 #

현재 제한사항 #

최적 성능을 위한 팁 #

쿠키 설정

필수 쿠키

분석 쿠키

마케팅 쿠키

진단 로그

로그 접근 방법

로그 구조

로그 보관

로그에 기록되는 내용

로그를 이용한 문제 해결

콘텐츠 로딩 문제

이미지가 로드되지 않음

웹 페이지가 로드되지 않음

영상 재생 문제

영상이 로드되지 않음

영상이 끊기거나 프레임이 누락됨

화면 문제

두 번째 화면이 감지되지 않음

화면 배열이 일치하지 않음

동기화 문제

화면이 동기화되지 않음 (로컬)

네트워크 동기화가 작동하지 않음

수일 운영 후 점진적 동기화 오차

동기화 보정으로 인한 끊김

라이브 시작 문제

전체 화면 창이 나타나지 않음

ESC 키로 라이브 모드가 종료되지 않음

앱 문제

FloSync이 시작되지 않음

높은 CPU/메모리 사용량

영상 코덱 문제

알려진 제한사항

현재 제한사항

최적 성능을 위한 팁