update desc

README.md

@@ -21,7 +21,7 @@
   <img src="https://github.com/jshsakura/passion-gamer/blob/master/screenshots/preview-passion-gamer2.png?raw=true"></img>
 </p>
 
-- `설정`의 버튼을 눌러 설정 팝업을 띄우고 `폴더 선택` 버튼을 눌러 롬 파일 경로를 지정하고 `저장`을 눌러줍니다.
+- `설정`의 버튼을 눌러 설정 팝업을 띄우고 `폴더 선택` 버튼을 눌러 롬 폴더 경로를 지정하고 `저장`을 눌러줍니다.
 <br/>
 <p align="center">
   <img src="https://github.com/jshsakura/passion-gamer/blob/master/screenshots/preview-passion-gamer3.png?raw=true"></img>
@@ -47,7 +47,8 @@
 </p>
 
 - 만약 조회된 목록에서 롬 파일 명을 확인하고 누락된 건이 있다면 입력해줍니다.
-- 사전 입력된 한글 롬파일 목록은 무적풍화륜 소통카페의 `삼색이냥`님이 고생해주셨습니다. (너무나 감사합니다.)
+- 사전 입력된 한글 롬파일 목록은 무적풍화륜 소통카페의 `삼색이냥`님이 고생해주셨습니다. 감사합니다.
+- 아케이드 한글 바로가기의 경우 `드드라`님이 고생해주셨습니다. 마찬가지로 감사합니다.
 - 전체 한글 롬 파일명 목록은 [구글 독스](https://docs.google.com/spreadsheets/d/1TCoolDlFeeaH3LgBsC6shHvN7u_Tk5liIAX56BhsfSs/edit?usp=sharing)에서 확인이 가능합니다.
 
 <br/>
@@ -85,10 +86,47 @@
 </p>
 
 - 본 프로그램은 SD 카드의 롬 폴더 내의 파일 명을 실제로 직접 변경하기 때문에, 아무쪼록 백업이 중요하며 사용에 주의가 필요합니다.
+
+<br/>
+<p align="center">
+  <img src="https://github.com/jshsakura/passion-gamer/blob/master/screenshots/preview-passion-gamer10.png?raw=true"></img>
+</p>
+
 - 한글 목록으로 변환 이후 영문 키보드만 지원하는 덕에 검색이 불가능해지거나 기존 게임의 [숏컷 링크](https://cafe.naver.com/moopung?iframe_url=/ArticleSearchList.nhn%3Fsearch.clubid=29771102%26search.searchdate=all%26search.searchBy=3%26search.query=%BB%EF%BB%F6%C0%CC%B3%C9%26search.defaultValue=1%26search.sortBy=date) 가 동작하지 않기 때문에 직접 사용자가 수정이 필요합니다.
 
 - 네이버 무적풍화륜님의 소통카페 측 [숏컷 링크](https://cafe.naver.com/moopung?iframe_url=/ArticleSearchList.nhn%3Fsearch.clubid=29771102%26search.searchdate=all%26search.searchBy=3%26search.query=%BB%EF%BB%F6%C0%CC%B3%C9%26search.defaultValue=1%26search.sortBy=date) 수정 방법을 참고해 `SF2000`의 SD 카드 안에 `Resource` 폴더의 `xfgle.hgp` 파일을 교체하거나 수정해줘야만 정상적으로 사용이 가능합니다.
 
+- 한글명으로 해당 롬의 파일명을 수정한 경우, 링크 기능은 하단의 `한글 숏컷 설치` 버튼을 누르면 설치가 가능합니다.
+
+<br/>
+<p align="center">
+  <img src="https://github.com/jshsakura/passion-gamer/blob/master/screenshots/preview-passion-gamer11.png?raw=true"></img>
+</p>
+
+- `한글 숏컷`이 적용되는 롬 파일 항목의 경우 파일명 수정시 직접 `Resources` 폴더의 파일을 수정해야하기 때문에 수정하려는 경우 위와 같은 경고가 나타납니다.
+
+<br/>
+<p align="center">
+  <img src="https://github.com/jshsakura/passion-gamer/blob/master/screenshots/preview-passion-gamer12.png?raw=true"></img>
+</p>
+
+- 추가로 무작정 파일 교체를 하는 것이 아닌, 롬 폴더에 실제 한글 숏컷을 위한 롬 파일이 존재하는 경우에만 `한글 숏컷`이 적용됩니다.
+
+<br/>
+<p align="center">
+  <img src="https://github.com/jshsakura/passion-gamer/blob/master/screenshots/preview-passion-gamer13.png?raw=true"></img>
+</p>
+
+- `SF2000`의 SD 카드 내기본 테마를 인디케이터가 포함된 무려 한글 테마로 변경하는 `드드라`님의 커스텀 에픽 느와르 테마입니다.
+
+<br/>
+<p align="center">
+  <img src="https://github.com/jshsakura/passion-gamer/blob/master/screenshots/preview-passion-gamer14.png?raw=true"></img>
+</p>
+
+- 상단의 `드드라 테마` 버튼을 클릭하면 `SF2000`의 `Resources` 폴더에 파일을 확인하고, 테마 적용에 필요한 44개의 파일이 존재하면 해당 파일들을 덮어 쓰게 됩니다.
+- 혼쾌히 테마를 제공해주신 `드드라`님께 감사드립니다.
+
 <br/>
 
 ## 💌 무한한 감사를 드립니다. 🫶
@@ -98,4 +136,5 @@
 - 프로그램의 로딩 오버레이 아이콘은 [loading.io](https://loading.io) 에서 무료 `svg` 아이콘을 이용하고 있습니다.
 - 롬파일의 썸네일 추출을 위해 [tadpole](https://github.com/EricGoldsteinNz/tadpole) 이 수정한 `frogtool.py`을 적용했습니다.
 - 기종별 아이콘은 `Onion OS`의 [Dot-art by Yoshi-kun](https://github.com/OnionUI/Themes) 를 적용했습니다.
+- 테마 설치 기능은 무적풍화륜 소통카페의 [드드라 테마](https://cafe.naver.com/moopung?iframe_url_utf8=%2FArticleRead.nhn%253Fclubid%3D29771102%2526articleid%3D147884%2526commentFocus%3Dtrue) 를 허락 받아 적용했습니다.
 - 친절한 도우미, 그러나 심각하게 멍청한 [ChatGPT](https://chat.openai.com/)의 코드 리팩토링 서포트.

core/gui/behavior.py

@@ -1,16 +1,14 @@
 import os
 import logging
-from pathlib import Path
 import shutil
 from .frogtool import zxx_ext
 
-from PyQt5.QtCore import Qt, QThreadPool, QSize
+from PyQt5.QtCore import Qt, QThreadPool, QSize, QTimer
 from PyQt5.QtGui import QColor
 from core.gui.worker import RomScannerWorker
 from .helpers import *
 from PyQt5.QtWidgets import QFileDialog
 from PyQt5.QtGui import QStandardItem, QImage, QIcon, QPixmap
-from PyQt5.QtWidgets import QApplication
 
 
 class GuiBehavior:
@@ -26,6 +24,7 @@ def __init__(self, gui):
         self.current_roms_list = []  # 현재 페이지의 롬 목록
         self.remove_roms_list = []  # 삭제할 롬 목록
         self.except_roms_list = []  # 삭제할 롬 목록
+        self.msg_box = None
 
     def get_current_page_roms(self):
         # 현재 페이지에 해당하는 롬 목록을 반환
@@ -82,13 +81,54 @@ def handle_init(self):
             settings.append(1)
         self.settings = settings
 
-    def set_resource_install(self, action):
+    def check_shortcut_files(self):
         # 롬 폴더 경로 (이미 알고 있는 경로로 설정하세요)
         roms_folder = get_settings('directory')
+        roms_list = []
+        # 검색할 platform_name 값들
+        target_platforms = ['ARCADE', 'FC', 'GB', 'GBA', 'GBC',
+                            'MD', 'SFC']  # 'ARCADE'는 zfb 교체
+        target_file_extension = ['.zfb', '.zfc',
+                                 '.zgb', '.zmd', '.zsf']
+        # 숏컷 대상 파일
+        shortcut_links = get_db_shortcut_game_name()
+
+        if roms_folder:
+            for root, dirs, files in os.walk(roms_folder):
+                for file in files:
+                    rom_path = os.path.normpath(os.path.join(root, file))
+                    file_extension = os.path.splitext(file)[-1].lower()
+                    origin_filename = get_file_name_without_extension(rom_path)
+                    platform_name = get_platform_name(rom_path)
+
+                    if file_extension in target_file_extension and platform_name in target_platforms and origin_filename in shortcut_links:
+                        shortcut_links.remove(origin_filename)
+                        logging.debug(
+                            f'한글 숏컷 대상인 {platform_name} 플랫폼의 [ {origin_filename} ] 을 찾았습니다!')
+
+        # 숏컷 갯수 체크
+        if len(shortcut_links) == 0:
+            return True
+        else:
+            return False
+
+    def set_resource_install(self, action):
+        # 롬 폴더 경로
+        roms_folder = get_settings('directory')
         # 검색할 폴더
         target_folder = 'Resources'
         resources_path = None
         custom_resources_files = []
+        # 작업명 설정
+        work_name = '드드라 테마' if action == 'theme' else '한글 숏컷'
+
+        if action == 'shortcut':
+            find_shortcut = self.check_shortcut_files()
+            if not find_shortcut:
+                alert(
+                    f'롬 폴더에 {work_name}을 설정하려면 우선 롬 파일을 한글 파일명으로 수정해야합니다.\n설정하신 파일 경로에서 한글 숏컷에 해당되는 한글 롬 파일명을 검색하지 못했습니다.\n아직 파일명을 변경하지 않았다면 먼저 파일명을 변경해주세요.')
+                return
+
         # 리소스 폴더 검색
         if roms_folder:
             # 리소스 폴더 검색
@@ -160,9 +200,9 @@ def set_resource_install(self, action):
                         logging.debug(f"패치를 위해 {custom_file}를 덮어썼습니다.")
 
         # 5. 최종 작업 결과 알림.
-        work_name = '드드라 테마' if action == 'theme' else '한글 숏컷'
         if change_files > 0 and change_files == target_resources_cnt:
-            alert(f'Resources 폴더 안에 파일을 덮어쓰고, {work_name} 설치 작업이 완료되었습니다.')
+            alert(
+                f'Resources 폴더 안에 파일을 덮어쓰고, {work_name} 설치 작업이 완료되었습니다.')
         elif change_files > 0:
             alert(
                 f'{work_name} 설치를 위해 필요한 총 {target_resources_cnt} 개의 파일 중 {change_files} 개만 검색되었습니다.\n[설정] 버튼을 눌러 선택하신 SD 카드 경로를 확인해주세요.')
@@ -246,8 +286,8 @@ def get_roms_list(self, action):
 
                         roms_list.append({"file_path": rom_path, "platform_name": platform_name, "origin_filename": origin_filename, "shortcut_link": shortcut_link,
                                           "new_filename": new_filename, "status": status, "status_name": status_name, "file_size": file_size, "file_byte_size": file_byte_size, "thumbnail": thumbnail, "platform_icon": platform_icon})
-        else:
-            alert('설정하신 롬 파일 경로가 없습니다.')
+        # else:
+        #     alert('설정하신 롬 폴더 경로가 없습니다.')
 
         self.all_roms_list = roms_list
 
@@ -440,6 +480,12 @@ def roms_scan(self):
         self.all_roms_list = []
         self.current_roms_list = []
 
+        # 롬 폴더 경로 설정 확인
+        roms_folder = get_settings('directory')
+        if not roms_folder:
+            alert('설정하신 롬 폴더 경로가 없습니다.')
+            return
+
         # 스캔 시작 버튼을 누를 때 로딩 오버레이를 표시합니다.
         worker = RomScannerWorker(self, action='scan')
         worker.signals.showLoading.connect(self.gui.show_loading_overlay)
@@ -454,6 +500,12 @@ def roms_unnecessary(self):
         self.all_roms_list = []
         self.current_roms_list = []
 
+        # 롬 폴더 경로 설정 확인
+        roms_folder = get_settings('directory')
+        if not roms_folder:
+            alert('설정하신 롬 폴더 경로가 없습니다.')
+            return
+
         # 스캔 시작 버튼을 누를 때 로딩 오버레이를 표시합니다.
         worker = RomScannerWorker(self, action='unnecessary')
         worker.signals.showLoading.connect(self.gui.show_loading_overlay)
@@ -464,7 +516,8 @@ def roms_unnecessary(self):
     def roms_replace(self):
         # 테이블이 비었는지 확인
         if self.gui.table_model.rowCount() == 0:
-            alert('현재 화면의 수정 목록이 비어 있습니다.\n먼저 설정에서 롬 폴더를 지정하고 롬 파일을 검색해야합니다.')
+            alert(
+                '현재 화면의 수정 목록이 비어 있습니다.\n먼저 설정에서 롬 폴더를 지정하고 롬 파일을 검색해야합니다.')
             return
 
         if not self.confirm_bulk_rename():
@@ -762,3 +815,22 @@ def sort_all_roms_list(self, column, order):
 
         # 현재 페이지를 다시 그립니다.
         self.populate_table_with_roms()
+
+    # def alert(self, text):
+    #     # 이미 열려 있는 메시지 박스를 닫음
+    #     if self.msg_box:
+    #         self.msg_box.close()
+
+    #     # 새로운 메시지 박스 생성
+    #     self.msg_box = QMessageBox()
+    #     self.msg_box.setIcon(QMessageBox.Information)
+    #     self.msg_box.setWindowTitle('안내')
+    #     self.msg_box.setText(text)
+    #     self.msg_box.setGeometry(
+    #         int(self.gui.main.geometry().center().x() - 150 // 2),
+    #         int(self.gui.main.geometry().center().y() - 100 // 2),
+    #         150,
+    #         100
+    #     )
+
+    #     self.msg_box.exec_()

core/gui/gui.py

@@ -13,9 +13,9 @@
 from PyQt5.QtGui import QIcon, QStandardItemModel, QPixmap, QFontDatabase, QFont, QColor
 from PyQt5.QtWidgets import (QApplication, QMainWindow, QGridLayout, QPushButton,  QWidget,
                              QTableView,  QHBoxLayout, QVBoxLayout, QAbstractItemView, QMenu, QAction,
-                             QAbstractScrollArea, QLabel, QLineEdit, QStackedWidget, QToolTip,
+                             QAbstractScrollArea, QLabel, QLineEdit, QStackedWidget, QMessageBox,
                              QFormLayout, QListWidget, QComboBox, QSizePolicy, QHeaderView, QHeaderView, QStyledItemDelegate)
-from .helpers import absp, database_init, alert
+from .helpers import *
 
 
 class Gui:
@@ -24,6 +24,7 @@ def __init__(self):
         self.app_name = 'Retro Passion gamer'
         self.font = None
         self.table_model = None
+        self.msg_box = None
 
         # Init DB
         database_init()
@@ -142,7 +143,7 @@ def main_init(self):
         self.main.settings_btn.clicked.connect(lambda: self.settings.show(
         ) if not self.settings.isVisible() else self.settings.raise_())
         self.main.theme_btn = QPushButton(
-            QIcon(absp('res/icon/smile.svg')), ' 드드라 테마 설치')
+            QIcon(absp('res/icon/smile.svg')), ' 드드라 테마')
         self.main.shortcut_btn = QPushButton(
             QIcon(absp('res/icon/external-link.svg')), ' 한글 숏컷 설치')
 
@@ -177,6 +178,7 @@ def main_init(self):
 
         hbox.addWidget(self.main.refresh_btn)
         hbox.addWidget(self.main.remove_cn_btn)
+        hbox.addWidget(self.main.shortcut_btn)
         hbox.addWidget(self.main.except_btn)
         hbox.addWidget(self.main.remove_btn)
         hbox.addWidget(self.main.edit_btn)
@@ -211,16 +213,15 @@ def main_init(self):
 
         grid.addWidget(self.main.settings_btn, 1, 0)
         grid.addWidget(self.main.theme_btn, 1, 1)
-        grid.addWidget(self.main.shortcut_btn, 1, 2)
-        grid.addWidget(self.main.page_label, 1, 3)
-        grid.addWidget(button_container, 1, 4)
+        grid.addWidget(self.main.page_label, 1, 4)
+        grid.addWidget(button_container, 1, 5)
 
         self.main.setWindowFlags(self.main.windowFlags()
                                  & Qt.CustomizeWindowHint)
 
         # Append widgets to grid
-        grid.addWidget(self.table, 2, 0, 1, 5)
-        grid.addLayout(hbox, 3, 0, 1, 5)
+        grid.addWidget(self.table, 2, 0, 1, 6)
+        grid.addLayout(hbox, 3, 0, 1, 6)
         widget.setLayout(grid)
         self.main.resize(720, 450)
         # Set size policies for the table

core/gui/helpers.py

@@ -55,32 +55,6 @@ def abs_config(path):
     return resolved_path
 
 
-def alert(text):
-    '''
-    Create and show QMessageBox Alert.
-    '''
-    msg = QMessageBox()
-    msg.setIcon(QMessageBox.Warning)
-    msg.setWindowTitle('안내')
-    # 화면 중앙 좌표 계산
-    screen_geo = QApplication.primaryScreen().geometry()
-    screen_center = screen_geo.center()
-
-    # 메시지 박스의 크기를 설정
-    msg_box_width = 300  # 메시지 박스의 너비
-    msg_box_height = 200  # 메시지 박스의 높이
-
-    # 메시지 박스를 화면 중앙으로 이동
-    msg.setGeometry(
-        screen_center.x() - msg_box_width // 2,
-        screen_center.y() - msg_box_height // 2,
-        msg_box_width,
-        msg_box_height
-    )
-    msg.setText(text)
-    msg.exec_()
-
-
 def create_file(f):
     '''
     Create empty file.
@@ -149,6 +123,20 @@ def get_db_game_name(platform_name, origin_filename):
     return {"kr_filename": '', "shortcut_link": ''}
 
 
+def get_db_shortcut_game_name():
+    category = 'gamelists'
+    conn = sqlite3.connect('app/local.db')
+    c = conn.cursor()
+    c.execute(
+        "SELECT kr_filename FROM gamelists WHERE shortcut_link IS NOT NULL AND shortcut_link != ''")
+    # 모든 레코드 가져오기
+    results = c.fetchall()
+    # 연결 종료
+    conn.close()
+    # 결과 반환
+    return [row[0] for row in results] if results else []
+
+
 def set_settings(key, value):
     category = 'settings'
     conn = sqlite3.connect('app/local.db')
@@ -189,3 +177,30 @@ def get_platform_name(file_path):
     last_folder = directories[-1]
 
     return last_folder
+
+
+def alert(text):
+    '''
+    Create and show QMessageBox Alert.
+    '''
+    msg = QMessageBox()
+    msg.setIcon(QMessageBox.Warning)
+    msg.setWindowTitle('안내')
+    # 화면 중앙 좌표 계산
+    screen_geo = QApplication.primaryScreen().geometry()
+    screen_center = screen_geo.center()
+
+    # 메시지 박스의 크기를 설정
+    msg_box_width = 300  # 메시지 박스의 너비
+    msg_box_height = 200  # 메시지 박스의 높이
+
+    # 메시지 박스를 화면 중앙으로 이동
+    msg.setGeometry(
+        screen_center.x() - msg_box_width // 2,
+        screen_center.y() - msg_box_height // 2,
+        msg_box_width,
+        msg_box_height
+    )
+
+    msg.setText(text)
+    msg.exec_()