베타 소프트웨어

FloSync은 현재 베타 버전입니다. 사용자 피드백에 따라 기능이 빠르게 변경될 수 있습니다.

문서 메뉴

문제 해결

이 가이드에서는 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 실행 시 자동으로 정리됩니다. 디스크 공간을 과도하게 쓰지 않으면서 문제 해결에 충분한 이력을 유지합니다.

로그에 기록되는 내용

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

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

로그를 이용한 문제 해결

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

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

콘텐츠 로딩 문제

이미지가 로드되지 않음

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

가능한 원인 및 해결 방법:

  1. 지원되지 않는 형식

    • 지원 형식: PNG, JPG/JPEG, GIF, BMP, TIFF, WebP, SVG
    • 다른 이미지 뷰어에서 열어 파일이 손상되지 않았는지 확인하세요

  2. 파일 권한

    • 이미지 파일에 대한 읽기 권한이 있는지 확인하세요
    • 네트워크 공유에 있다면 로컬 드라이브로 복사해 보세요

  3. SVG 제한사항

    • 일부 복잡한 SVG 기능은 제대로 렌더링되지 않을 수 있습니다
    • SVG가 올바르게 표시되지 않으면 PNG로 변환해 보세요

웹 페이지가 로드되지 않음

증상: 화면에 웹 페이지가 빈 화면이거나 오류가 표시됩니다.

가능한 원인 및 해결 방법:

  1. HTTP vs HTTPS

    • HTTPS URL만 지원됩니다 (HTTP 미지원)
    • URL이 https://로 시작하는지 확인하세요

  2. 네트워크 연결

    • 인터넷에 접속 가능한지 확인하세요
    • 일반 브라우저에서 해당 사이트에 접속할 수 있는지 확인하세요

  3. 웹사이트의 임베딩 차단

    • 일부 웹사이트는 WebView 포함을 차단합니다
    • 다른 사이트를 시도하거나 로컬 HTML 파일을 대신 사용하세요

영상 재생 문제

영상이 로드되지 않음

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

가능한 원인 및 해결 방법:

  1. 지원되지 않는 형식

    • MP4 (H.264)로 변환해 보세요 — 아래 영상 코덱 권장사항을 참조하세요
    • 다른 영상 플레이어에서 재생하여 파일이 손상되지 않았는지 확인하세요

  2. 코덱 누락

    • FloSync에는 대부분의 일반 코덱이 포함되어 있지만, 일부 독점 형식은 지원되지 않을 수 있습니다
    • MP4 같은 표준 형식으로 변환하세요

  3. 파일 권한

    • 영상 파일에 대한 읽기 권한이 있는지 확인하세요
    • 네트워크 공유에 있다면 로컬 드라이브로 복사해 보세요

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

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

해결 방법:

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

화면 문제

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

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

해결 방법:

  1. OS 디스플레이 설정 확인

    • macOS: 시스템 설정 > 디스플레이
    • Windows: 설정 > System > Display
    • OS에서 모든 화면이 감지되는지 확인하세요

  2. 케이블 연결 확인

    • 다른 케이블 시도
    • 컴퓨터의 다른 포트 시도

  3. 새 화면 연결 후 FloSync 재시작

    • FloSync는 실행 시점에 화면을 감지합니다

화면 배열이 일치하지 않음

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

해결 방법:

  1. OS 화면 배열 설정

    • macOS: 시스템 설정 > 디스플레이 > Arrange
    • Windows: 설정 > System > Display (드래그하여 배열)
    • 가상 배열을 실제 물리적 배치와 일치시키세요

  2. 배열 변경 후 FloSync 재시작

동기화 문제

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

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

해결 방법:

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

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

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

해결 방법:

  1. 같은 네트워크 확인

    • 두 컴퓨터가 같은 로컬 네트워크에 있어야 합니다
    • 컴퓨터 간 핑으로 확인하세요

  2. 같은 영상 파일

    • 클라이언트에도 동일한 영상이 로드되어 있어야 합니다
    • 영상 길이가 다르면 동기화가 실패합니다

  3. 방화벽 확인

    • 양쪽 컴퓨터에서 방화벽을 통해 FloSync를 허용하세요
    • UDP 포트 9201을 허용하세요

  4. 서버 실행 확인

    • 상단 바에서 서버 아이콘(타워)이 녹색인지 확인하세요
    • 상태 바에 "Server"가 표시되는지 확인하세요
    • 아이콘을 클릭하여 서버 모드를 중지했다가 다시 시작해 보세요

  5. 초기 안정화 대기

    • 네트워크 동기화는 연결 직후 잠시 안정화 시간이 필요할 수 있습니다
    • 초기 보정은 정상입니다
    • 안정화 후에는 재생이 안정적이고 시각적으로 정렬된 상태를 유지해야 합니다

수일 운영 후 점진적 동기화 드리프트

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

원인: 모든 컴퓨터의 시스템 시계는 하드웨어 오실레이터 편차와 온도로 인해 미세하게 다른 속도로 드리프트합니다. 며칠간 중단 없이 가동하면 이 누적 드리프트가 실시간 보정으로 보상할 수 있는 범위를 넘을 수 있습니다. 이는 FloSync만의 문제가 아니라, 시계 기반 동기화 시스템 모두에 해당됩니다.

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

동기화 보정으로 인한 끊김

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

해결 방법:

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

라이브 시작 문제

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

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

해결 방법:

  1. 화면 감지 확인

    • 화면이 감지되었는지 확인하세요 (화면 배열 영역에 표시되어야 합니다)
    • 화면을 분리했다가 다시 연결해 보세요
    • 새 화면 연결 후 FloSync를 재시작하세요

  2. 영상 로딩 확인

    • 라이브 시작 전에 최소 하나의 영상이 로드되어 있는지 확인하세요
    • "missing video" 표시가 있는지 확인하세요

  3. 권한 확인

    • macOS: FloSync에 접근성 권한이 있는지 확인하세요 (시스템 설정 > 개인 정보 보호 및 보안 > 손쉬운 사용)
    • Windows: 관리자 권한으로 FloSync를 실행해 보세요

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

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

해결 방법:

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

앱 문제

FloSync이 실행되지 않음

macOS 해결 방법:

  1. 보안 설정

    • FloSync를 우클릭하고 "Open"을 선택하세요
    • 또는: 시스템 설정 > Privacy & Security에서 FloSync 허용

  2. 환경설정 초기화

    • 삭제: ~/Library/Application Support/com.tentekio.flosync/
    • FloSync를 다시 실행하세요

Windows 해결 방법:

  1. 관리자 권한으로 실행

    • FloSync를 우클릭 > 관리자 권한으로 실행

  2. 환경설정 초기화

    • 삭제: %APPDATA%\Tentekio\FloSync\
    • FloSync를 다시 실행하세요

  3. Visual C++ 재배포 가능 패키지 재설치

    • Microsoft에서 최신 버전을 다운로드하세요

높은 CPU/메모리 사용량

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

해결 방법:

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

영상 코덱 문제

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

빠른 해결: 최적의 동기화 성능을 위해 영상을 H.264 All-Intra로 트랜스코딩하세요. 전문 환경에서는 ProRes LT (macOS) 또는 DNxHD (Windows)를 대안으로 사용할 수 있습니다.

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

알려진 제한사항

현재 제한사항

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

최적 성능을 위한 팁

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