Syncord

                                                                  $$\ 
                                                                  $$ |
 $$$$$$$\ $$\   $$\ $$$$$$$\   $$$$$$$\  $$$$$$\   $$$$$$\   $$$$$$$ |
$$  _____|$$ |  $$ |$$  __$$\ $$  _____|$$  __$$\ $$  __$$\ $$  __$$ |
\$$$$$$\  $$ |  $$ |$$ |  $$ |$$ /      $$ /  $$ |$$ |  \__|$$ /  $$ |
 \____$$\ $$ |  $$ |$$ |  $$ |$$ |      $$ |  $$ |$$ |      $$ |  $$ |
$$$$$$$  |\$$$$$$$ |$$ |  $$ |\$$$$$$$\ \$$$$$$  |$$ |      \$$$$$$$ |
\_______/  \____$$ |\__|  \__| \_______| \______/ \__|       \_______|
          $$\   $$ |                                                  
          \$$$$$$  |                                                  
           \______/ 

Syncord는 Discord를 암호화된 파일 저장소로 사용하는 CLI 기반 파일 동기화 및 저장 도구입니다.

파일이나 전체 디렉토리를 Discord에 업로드하고, 로컬에서 암호화 및 분할한 뒤, 나중에 안전하게 다운로드하고 재조립할 수 있습니다. 모든 작업은 간단한 명령줄 인터페이스 또는 선택적인 TUI 대시보드를 통해 수행됩니다.

Syncord는 PyInstaller로 빌드된 단일 실행 파일(syncord.exe) 로 배포됩니다. 이 실행 파일을 시스템 PATH에 바로 넣고 어디서든 사용할 수 있습니다.

✨ 기능

• 🔐 종단간 암호화

  • 파일은 업로드 전에 로컬에서 암호화됩니다.
  • 암호화 키는 Discord에 저장되지 않습니다.
  • 키가 없으면 데이터를 복구할 수 없습니다. 업로드 후에는 키를 변경하지 않도록 주의하세요.

• 📦 자동 파일 분할

  • 큰 파일은 청크(chunk) 단위로 분할됩니다.
  • 청크는 Discord 업로드 제한을 준수합니다 (Discord 제한: 8MB; 청크 크기: 암호화 전 5MB; 암호화 후 약 7MB)
  • 다운로드 시 파일은 자연스럽게 재조립됩니다. SQLite가 파티션을 추적합니다.

• 📁 디렉토리 업로드

  • 전체 디렉토리를 한 번에 업로드할 수 있습니다.
  • 전체 디렉토리와 하위 디렉토리도 다운로드할 수 있습니다.

• 🖥️ CLI 우선 설계

  • 간단하고 스크립트 가능한 명령어.
  • PATH에 추가하면 어디서나 사용 가능.

• 🧭 TUI 대시보드

  • 대화형 터미널 인터페이스.
  • 저장된 파일 및 사용량 정보를 확인.

• 📊 사용량 통계

  • 업로드, 다운로드, 저장 공간 사용량 추적.

• 🗄️ 로컬 메타데이터 데이터베이스

  • SQLite 기반 메타데이터.
  • Discord 메시지 기록에만 의존하지 않습니다.

📦 설치

사전 빌드된 바이너리 (권장)

1. syncord.exe 다운로드
2. 시스템 PATH에 포함된 디렉토리에 배치
3. 설치 확인:

syncord --help

이제 어느 디렉토리에서든 Syncord를 실행할 수 있습니다.

⚙️ 필수 초기 설정

⚠️ Syncord는 첫 사용 전에 설정이 필요합니다.

Discord 봇 토큰과 Guild ID는 필수입니다.

필수 구성 요소

• Discord 봇 토큰.
• Discord Guild ID (파일이 업로드될 서버).
• 암호화 키 (로컬에서 생성).

1회성 설정 명령어

syncord setup --token YOUR_DISCORD_BOT_TOKEN --guild-id YOUR_GUILD_ID --encryption-key

중요 참고 사항

• 🔑 암호화 키는 매우 중요합니다.
• ❌ 키를 분실하면 영구적인 데이터 손실이 발생합니다.
• 🔒 Discord는 사용자의 파일을 복호화하거나 복구할 수 없습니다.
• 🛑 유효한 토큰과 Guild ID가 없으면 Syncord는 작동하지 않습니다.

📤 파일 업로드

단일 파일 업로드

syncord upload file.ext

전체 디렉토리 업로드

syncord upload folder_name

동작 방식:

• 디렉토리 안의 모든 파일이 처리됩니다.
• 폴더 구조는 논리적으로 보존됩니다.
• 각 디렉토리는 별도의 Syncord 폴더 네임스페이스가 됩니다.

📥 파일 다운로드

syncord download folder_on_syncord/file

Syncord는 다음을 수행합니다:

1. 필요한 모든 파티션을 찾습니다.
2. Discord에서 다운로드합니다.
3. 로컬에서 복호화합니다.
4. 원본 파일을 재조립합니다.

참고: 폴더를 지정하지 않으면 Syncord는 모든 파일이 업로드되는 default 폴더로 간주합니다.

🖥️ TUI 대시보드

syncord dashboard

대시보드에서 제공하는 기능:

• 저장된 파일 개요.
• 폴더 및 파일 다운로드.
• 저장 공간 사용량.
• 대화형 탐색.

📊 사용량 통계

syncord stats

표시 내용:

• 업로드된 총 파일 수
• 총 다운로드 수
• 저장 공간 사용량
• 기타 추적되는 지표

🧾 명령어 요약

syncord setup        필수 초기 설정
syncord upload       파일 또는 디렉토리 업로드
syncord download     파일 다운로드 및 재조립
syncord dashboard    터미널 UI 대시보드 실행
syncord stats        사용량 통계 표시

🔐 보안 모델

• 모든 암호화는 로컬에서 이루어집니다.
• Discord는 암호화된 바이너리 청크만 저장합니다.
• 메타데이터는 SQLite를 사용해 로컬에 저장됩니다.
• Discord는 다음 정보를 절대 볼 수 없습니다:
  • 파일 내용.
  • 평문 파일 이름.
  • 암호화 키.

Syncord는 Discord가 아닌 사용자 로컬 시스템을 신뢰한다고 가정합니다.

📁 프로젝트 구조

dist/
 ├── syncord.exe          # 실행 파일
core/
 ├── db_manager.py        # SQLite 메타데이터 처리
 ├── setup.py             # 구성 및 설정 로직
 ├── partition.py         # 파일 청크 분할 및 재조립
 ├── tui.py               # 터미널 UI 대시보드
 ├── encrypter.py         # 암호화 및 복호화
 ├── discord_handler.py   # Discord 봇 로직
files/
 ├── uuid/file.bin        # 임시 저장소
main.py                   # CLI 진입점

⚠️ 제한 사항 및 참고 사항

• 적절한 길드 권한이 있는 Discord 봇이 필요합니다. READ_MESSAGE_HISTORY, VIEW_CHANNEL, SEND_MESSAGES, ATTACH_FILES
• Discord의 속도 제한(rate limit)이 적용됩니다.
• 공개 클라우드 저장소를 대체하기 위한 용도는 아닙니다.
• 개인용 또는 통제된 환경을 위해 설계되었습니다.

📜 면책 조항

이 프로젝트는 교육 및 개인용으로 제작되었습니다.
Syncord를 사용할 때 Discord의 서비스 약관을 준수하십시오.

🧠 향후 업데이트

다음과 같은 문제가 발생할 수 있으며 곧 수정될 예정입니다:

• 다중 업로드 시 봇의 지속적인 연결/해제로 인한 Discord의 속도 제한(rate limiting).
  • 최선의 해결책: 연결을 유지하거나 각 파일을 개별적으로 처리하는 대신 일괄 업로드/다운로드를 수행하는 것. partition.py를 약간 재작성해야 합니다.
• 닫히지 않은 aiohttp 클라이언트로 인한 예기치 않은 오류.