Release v0.2.20

Cargo.lock

@@ -182,7 +182,7 @@ checksum = "3d7b894f5411737b7867f4827955924d7c254fc9f4d91a6aad6b097804b1018b"
 
 [[package]]
 name = "comicviewer"
-version = "0.2.17"
+version = "0.2.20"
 dependencies = [
  "anyhow",
  "chrono",

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "comicviewer"
-version = "0.2.17"
+version = "0.2.20"
 edition = "2024"
 description = "A comic archive viewer for local and remote locations"
 license = "GPL-3.0-or-later"
@@ -8,7 +8,7 @@ license = "GPL-3.0-or-later"
 [dependencies]
 anyhow = "1.0"
 chrono = { version = "0.4", default-features = false, features = ["clock"] }
-gtk = { package = "gtk4", version = "0.10", features = ["v4_10"] }
+gtk = { package = "gtk4", version = "0.10", features = ["v4_12"] }
 image = { version = "0.25", default-features = false, features = ["avif-native", "bmp", "gif", "jpeg", "png", "webp"] }
 filetime = "0.2"
 flate2 = "1.0"

data/io.github.comicviewer.Comicviewer.metainfo.xml

@@ -26,6 +26,9 @@
   </provides>
   <content_rating type="oars-1.1" />
   <releases>
+    <release version="0.2.20" date="2026-08-21" />
+    <release version="0.2.19" date="2026-08-21" />
+    <release version="0.2.18" date="2026-08-21" />
     <release version="0.2.17" date="2026-08-21" />
     <release version="0.2.16" date="2026-08-21" />
     <release version="0.2.15" date="2026-08-21" />

docs/INSTALL.ko.md

@@ -14,7 +14,7 @@ sudo pacman -S fuse2 gtk4 dav1d gvfs gvfs-smb gstreamer curl \
 ```
 
 - `fuse2`: AppImage 마운트 및 실행
-- `gtk4`, `dav1d`: 화면 표시와 이미지 디코딩
+- `gtk4` 4.12 이상, `dav1d`: 화면 표시와 이미지 디코딩
 - `gvfs`: FTP와 SFTP 접근
 - `gvfs-smb`: SMB 공유 접근
 - `gstreamer`, `gst-plugins-*`, `gst-libav`: MP4 등 동영상 재생
@@ -84,6 +84,8 @@ Comicviewer는 XDG 표준 경로를 사용합니다.
 - 메인 창의 `캐시 비우기` 버튼으로 현재 열려 있지 않은 ZIP 캐시를 직접 삭제할 수 있습니다.
 - 캐시 한도는 설정 파일의 `cache_quota_gb`로 변경하며, 0은 영구 캐시를 사용하지 않는 값입니다.
 - 메인 창 검색은 현재 표시 중인 폴더의 파일명을 필터링하며, 입력을 지우면 전체 목록을 복원합니다.
+- 위치 목록의 `최근 열어본 파일`은 성공적으로 연 ZIP·이미지·동영상을 최신순으로 최대 100개 보관합니다.
+- 최근 파일 기록에는 원격 위치 재접속 정보가 함께 저장되며 `최근 기록 비우기`로 전체 기록만 삭제할 수 있습니다.
 
 ## 뷰어 조작
 

docs/RELEASING.ko.md

@@ -55,7 +55,7 @@ AppImage 빌드가 끝나면 다음 스크립트로 체크섬과 통합 `tar.gz`
 
 스크립트는 `Cargo.toml`에서 버전을 읽고 다음 파일을 생성합니다.
 
-- `dist/Comicviewer-0.2.17-x86_64.AppImage.sha256`
+- `dist/Comicviewer-0.2.20-x86_64.AppImage.sha256`
 - `dist/Comicviewer-latest-x86_64.tar.gz`
 - `dist/Comicviewer-latest-x86_64.tar.gz.sha256`
 
@@ -78,10 +78,10 @@ sha256sum -c Comicviewer-latest-x86_64.tar.gz.sha256
 
 ```sh
 git add Cargo.toml Cargo.lock data packaging README.md docs
-git commit -m "Release v0.2.17"
-git tag -a v0.2.17 -m "Comicviewer v0.2.17"
+git commit -m "Release v0.2.20"
+git tag -a v0.2.20 -m "Comicviewer v0.2.20"
 git push origin main
-git push origin v0.2.17
+git push origin v0.2.20
 ```
 
 이미 원격에 공개한 태그는 이동하거나 덮어쓰지 않습니다. 수정이 필요하면 새

src/config.rs

@@ -15,6 +15,7 @@ pub struct AppConfig {
     pub two_page_right_to_left: bool,
     pub locations: Vec<LocationProfile>,
     pub favorites: Vec<FavoriteEntry>,
+    pub recent_files: Vec<RecentFileEntry>,
 }
 
 impl Default for AppConfig {
@@ -27,6 +28,7 @@ impl Default for AppConfig {
             two_page_right_to_left: true,
             locations: Vec::new(),
             favorites: Vec::new(),
+            recent_files: Vec::new(),
         }
     }
 }
@@ -52,6 +54,13 @@ pub struct FavoriteEntry {
     pub profile: LocationProfile,
 }
 
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct RecentFileEntry {
+    pub name: String,
+    pub uri: String,
+    pub profile: LocationProfile,
+}
+
 #[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
 #[serde(rename_all = "lowercase")]
 pub enum LocationKind {
@@ -203,6 +212,18 @@ mod tests {
                     domain: String::new(),
                 },
             }],
+            recent_files: vec![RecentFileEntry {
+                name: "최근 영상.mp4".into(),
+                uri: "sftp://example.invalid/comics/recent.mp4".into(),
+                profile: LocationProfile {
+                    name: "최근 서버".into(),
+                    kind: LocationKind::Sftp,
+                    address: "sftp://example.invalid/comics".into(),
+                    username: "recent-reader".into(),
+                    password: "recent-password".into(),
+                    domain: String::new(),
+                },
+            }],
         };
 
         let encoded = toml::to_string(&config).unwrap();
@@ -210,6 +231,8 @@ mod tests {
         assert_eq!(decoded.locations[0].password, "plain-password");
         assert_eq!(decoded.favorites[0].profile.username, "favorite-reader");
         assert_eq!(decoded.favorites[0].profile.password, "favorite-password");
+        assert_eq!(decoded.recent_files[0].profile.username, "recent-reader");
+        assert_eq!(decoded.recent_files[0].profile.password, "recent-password");
     }
 
     #[test]
@@ -220,6 +243,7 @@ mod tests {
         assert_eq!(decoded.viewer_mode, ViewerMode::FitWidth);
         assert!(decoded.two_page_right_to_left);
         assert!(decoded.favorites.is_empty());
+        assert!(decoded.recent_files.is_empty());
     }
 
     #[test]

src/viewer.rs

@@ -28,6 +28,7 @@ const VIEWER_CONTROLLER_KEY: &str = "comicviewer-viewer-controller";
 const MEDIA_VIEWER_CONTROLLER_KEY: &str = "comicviewer-media-viewer-controller";
 const VIEWER_FILE_SEARCH_KEY: &str = "comicviewer-file-search";
 const VIEWER_FILE_SCROLL_KEY: &str = "comicviewer-file-scroll";
+const VIEWER_VIDEO_LOOP_KEY: &str = "comicviewer-video-loop";
 const PRESERVE_SEEK_CLASS: &str = "viewer-preserve-seek";
 
 fn clear_viewer_controller(window: &gtk::ApplicationWindow) {
@@ -1871,8 +1872,8 @@ impl ViewerController {
             if (zoom - 1.0).abs() >= f64::EPSILON {
                 let (width, height) = zoomed_picture_request(
                     self.view_mode(),
-                    self.single_scrolled.allocated_width().max(1),
-                    self.single_scrolled.allocated_height().max(1),
+                    self.single_scrolled.width().max(1),
+                    self.single_scrolled.height().max(1),
                     texture_width,
                     texture_height,
                     zoom,
@@ -1890,7 +1891,7 @@ impl ViewerController {
                 self.single_picture.set_size_request(width, height);
             } else if let Some((width, height)) = single_picture_request(
                 self.view_mode(),
-                self.stack.allocated_width().max(1),
+                self.stack.width().max(1),
                 texture_width,
                 texture_height,
             ) {
@@ -1934,8 +1935,8 @@ impl ViewerController {
         };
         drop(state);
         let count = visible.len().max(1) as i32;
-        let viewport_width = (self.spread_scrolled.allocated_width().max(1) - 8) / count;
-        let viewport_height = self.spread_scrolled.allocated_height().max(1);
+        let viewport_width = (self.spread_scrolled.width().max(1) - 8) / count;
+        let viewport_height = self.spread_scrolled.height().max(1);
         self.spread_box.set_homogeneous(false);
         self.spread_box.set_halign(gtk::Align::Center);
         self.spread_box.set_valign(gtk::Align::Center);
@@ -2176,7 +2177,7 @@ impl ViewerController {
     }
 
     fn continuous_content_width(&self) -> i32 {
-        continuous_content_width(self.stack.allocated_width())
+        continuous_content_width(self.stack.width())
     }
 
     fn evict_cache(&self) {
@@ -2277,6 +2278,7 @@ impl MediaViewerWindow {
             .as_ref()
             .map(viewer_file_scroll_position)
             .unwrap_or_default();
+        let video_loop_active = reuse_window.as_ref().is_some_and(viewer_video_loop_enabled);
         if let Some(window) = reuse_window.as_ref() {
             clear_viewer_controller(window);
         }
@@ -2300,6 +2302,7 @@ impl MediaViewerWindow {
         file_list_button.set_sensitive(sibling_navigator.is_some());
         file_list_button.set_active(window.has_css_class("viewer-file-list-visible"));
         let loop_check = gtk::CheckButton::with_label("반복 재생");
+        loop_check.set_active(video_loop_active);
         loop_check.set_visible(kind == EntryKind::Video);
         let image_mode_dropdown = gtk::DropDown::from_strings(&["100%", "폭 맞춤", "높이 맞춤"]);
         let (image_mode_selected, image_mode_change) =
@@ -2453,7 +2456,9 @@ impl MediaViewerWindow {
                 schedule_video_loop_restart(stream, &check, &restart_pending_for_timestamp);
             });
             let stream_for_loop_check = stream.clone();
+            let window_for_loop_check = controller.window.clone();
             loop_check.connect_toggled(move |check| {
+                store_viewer_video_loop(&window_for_loop_check, check.is_active());
                 schedule_video_loop_restart(&stream_for_loop_check, check, &restart_pending);
             });
         }
@@ -3066,8 +3071,8 @@ impl MediaViewerController {
         if (zoom - 1.0).abs() >= f64::EPSILON {
             let (width, height) = zoomed_picture_request(
                 self.image_view_mode(),
-                self.image_scrolled.allocated_width().max(1),
-                self.image_scrolled.allocated_height().max(1),
+                self.image_scrolled.width().max(1),
+                self.image_scrolled.height().max(1),
                 texture_width,
                 texture_height,
                 zoom,
@@ -3085,7 +3090,7 @@ impl MediaViewerController {
             self.picture.set_size_request(width, height);
         } else if let Some((width, height)) = single_picture_request(
             self.image_view_mode(),
-            self.stack.allocated_width().max(1),
+            self.stack.width().max(1),
             texture_width,
             texture_height,
         ) {
@@ -3626,6 +3631,20 @@ fn store_viewer_file_scroll_position(window: &gtk::ApplicationWindow, position:
     }
 }
 
+fn viewer_video_loop_enabled(window: &gtk::ApplicationWindow) -> bool {
+    unsafe {
+        window
+            .data::<bool>(VIEWER_VIDEO_LOOP_KEY)
+            .is_some_and(|active| *active.as_ref())
+    }
+}
+
+fn store_viewer_video_loop(window: &gtk::ApplicationWindow, active: bool) {
+    unsafe {
+        window.set_data(VIEWER_VIDEO_LOOP_KEY, active);
+    }
+}
+
 fn restore_viewer_file_scroll(scrolled: &gtk::ScrolledWindow, position: f64) {
     let scrolled = scrolled.clone();
     glib::idle_add_local_once(move || {
@@ -4093,16 +4112,13 @@ fn schedule_video_loop_restart(
     check: &gtk::CheckButton,
     pending: &Rc<Cell<bool>>,
 ) {
-    if !video_loop_restart_needed(
+    let restart_needed = video_loop_restart_needed(
         stream.is_ended(),
         stream.timestamp(),
         stream.duration(),
         check.is_active(),
-    ) {
-        pending.set(false);
-        return;
-    }
-    if pending.replace(true) {
+    );
+    if !begin_video_loop_restart(pending, restart_needed) {
         return;
     }
     let stream = stream.clone();
@@ -4110,6 +4126,7 @@ fn schedule_video_loop_restart(
     let pending = Rc::clone(pending);
     glib::timeout_add_local_once(Duration::from_millis(50), move || {
         let Some(check) = check.upgrade() else {
+            pending.set(false);
             return;
         };
         if video_loop_restart_needed(
@@ -4121,12 +4138,19 @@ fn schedule_video_loop_restart(
             stream.pause();
             stream.seek(0);
             stream.play();
-        } else {
-            pending.set(false);
         }
+        pending.set(false);
     });
 }
 
+fn begin_video_loop_restart(pending: &Cell<bool>, restart_needed: bool) -> bool {
+    if !restart_needed {
+        pending.set(false);
+        return false;
+    }
+    !pending.replace(true)
+}
+
 fn initialize_video_volume(stream: &gtk::MediaStream) {
     let volume = stream.volume().clamp(0.0, 1.0);
     // Force the realized playback backend and GTK controls to receive the same initial value.
@@ -4292,6 +4316,16 @@ mod tests {
         assert!(!video_loop_restart_needed(true, 10, 10, false));
     }
 
+    #[test]
+    fn video_loop_can_restart_more_than_once() {
+        let pending = Cell::new(false);
+        assert!(begin_video_loop_restart(&pending, true));
+        assert!(!begin_video_loop_restart(&pending, true));
+        pending.set(false);
+        assert!(begin_video_loop_restart(&pending, true));
+        assert!(!begin_video_loop_restart(&pending, false));
+    }
+
     #[test]
     fn image_pan_moves_at_most_100_pixels_and_consumes_clipped_axis() {
         assert_eq!(

src/window.rs

@@ -21,7 +21,9 @@ use tar::Archive;
 use crate::browser::{
     BrowserEntry, EntryKind, SortDirection, SortField, classify_file, sort_entries,
 };
-use crate::config::{AppConfig, FavoriteEntry, LocationKind, LocationProfile, ViewerMode};
+use crate::config::{
+    AppConfig, FavoriteEntry, LocationKind, LocationProfile, RecentFileEntry, ViewerMode,
+};
 use crate::database::Database;
 use crate::source::{
     display_remote_uri, ensure_mounted, enumerate_directory, enumerate_tree_entries,
@@ -36,6 +38,7 @@ use crate::viewer::{
 use crate::zip_cache::ZipCache;
 
 const MOUSE_BACK_BUTTON: u32 = 8;
+const RECENT_FILE_LIMIT: usize = 100;
 const UPDATE_BUNDLE_URL: &str =
     "https://burningtuna.cafe24.com/www/Downloads/Comicviewer/Comicviewer-latest-x86_64.tar.gz";
 const UPDATE_CHECKSUM_URL: &str = "https://burningtuna.cafe24.com/www/Downloads/Comicviewer/Comicviewer-latest-x86_64.tar.gz.sha256";
@@ -83,11 +86,14 @@ impl ComicWindow {
         edit_location_button.set_sensitive(false);
         let delete_location_button = gtk::Button::with_label("삭제");
         delete_location_button.set_sensitive(false);
+        let clear_recent_button = gtk::Button::with_label("최근 기록 비우기");
+        clear_recent_button.set_visible(false);
         locations.append(&gtk::Label::new(Some("위치")));
         locations.append(&location_dropdown);
         locations.append(&add_location_button);
         locations.append(&edit_location_button);
         locations.append(&delete_location_button);
+        locations.append(&clear_recent_button);
 
         let navigation = gtk::Box::new(gtk::Orientation::Horizontal, 6);
         let up_button = gtk::Button::builder()
@@ -149,6 +155,7 @@ impl ComicWindow {
             location_dropdown,
             edit_location_button,
             delete_location_button,
+            clear_recent_button: clear_recent_button.clone(),
             path_entry,
             search_entry,
             sort_dropdown,
@@ -159,7 +166,7 @@ impl ComicWindow {
             state: RefCell::new(BrowserState {
                 profile_index: 0,
                 favorite_profile: None,
-                browsing_favorites: false,
+                mode: BrowserMode::Directory,
                 root_uri: root_uri.clone(),
                 current_uri: root_uri,
                 entries: Vec::new(),
@@ -206,7 +213,7 @@ impl ComicWindow {
 struct BrowserState {
     profile_index: usize,
     favorite_profile: Option<LocationProfile>,
-    browsing_favorites: bool,
+    mode: BrowserMode,
     root_uri: String,
     current_uri: String,
     entries: Vec<BrowserEntry>,
@@ -218,6 +225,13 @@ struct BrowserState {
     typeahead_last_input: Option<Instant>,
 }
 
+#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+enum BrowserMode {
+    Directory,
+    Favorites,
+    Recent,
+}
+
 struct BrowserController {
     window: gtk::ApplicationWindow,
     about_button: gtk::Button,
@@ -225,6 +239,7 @@ struct BrowserController {
     location_dropdown: gtk::DropDown,
     edit_location_button: gtk::Button,
     delete_location_button: gtk::Button,
+    clear_recent_button: gtk::Button,
     path_entry: gtk::Entry,
     search_entry: gtk::SearchEntry,
     sort_dropdown: gtk::DropDown,
@@ -298,8 +313,10 @@ impl BrowserController {
                 let Some(controller) = controller.upgrade() else {
                     return;
                 };
-                if is_favorites_selection(item.position(), controller.profiles().len()) {
-                    controller.show_favorites();
+                match special_browser_mode(item.position(), controller.profiles().len()) {
+                    Some(BrowserMode::Favorites) => controller.show_favorites(),
+                    Some(BrowserMode::Recent) => controller.show_recent(),
+                    _ => {}
                 }
             });
             label.add_controller(click);
@@ -406,6 +423,9 @@ impl BrowserController {
         let controller = Rc::clone(self);
         self.clear_cache_button
             .connect_clicked(move |_| controller.show_clear_cache_dialog());
+        let controller = Rc::clone(self);
+        self.clear_recent_button
+            .connect_clicked(move |_| controller.show_clear_recent_dialog());
     }
 
     fn profiles(&self) -> Vec<LocationProfile> {
@@ -431,6 +451,7 @@ impl BrowserController {
             .map(|profile| profile.name.clone())
             .collect();
         names.push("즐겨찾기".into());
+        names.push("최근 열어본 파일".into());
         let names: Vec<_> = names.iter().map(String::as_str).collect();
         self.location_dropdown
             .set_model(Some(&gtk::StringList::new(&names)));
@@ -439,9 +460,16 @@ impl BrowserController {
     fn select_profile(self: &Rc<Self>) {
         let profile_index = self.location_dropdown.selected() as usize;
         let profiles = self.profiles();
-        if is_favorites_selection(self.location_dropdown.selected(), profiles.len()) {
-            self.show_favorites();
-            return;
+        match special_browser_mode(self.location_dropdown.selected(), profiles.len()) {
+            Some(BrowserMode::Favorites) => {
+                self.show_favorites();
+                return;
+            }
+            Some(BrowserMode::Recent) => {
+                self.show_recent();
+                return;
+            }
+            _ => {}
         }
         let editable = profile_index > 0 && profile_index < profiles.len();
         self.edit_location_button.set_sensitive(editable);
@@ -455,10 +483,11 @@ impl BrowserController {
                 let mut state = self.state.borrow_mut();
                 state.profile_index = profile_index;
                 state.favorite_profile = None;
-                state.browsing_favorites = false;
+                state.mode = BrowserMode::Directory;
                 state.root_uri = root_uri.clone();
                 state.current_uri = root_uri;
                 drop(state);
+                self.update_mode_controls(BrowserMode::Directory);
                 self.path_entry.set_editable(true);
                 self.search_entry.set_text("");
                 self.refresh();
@@ -484,24 +513,58 @@ impl BrowserController {
         state.generation = state.generation.wrapping_add(1);
         state.typeahead_query.clear();
         state.typeahead_last_input = None;
-        state.browsing_favorites = true;
+        state.mode = BrowserMode::Favorites;
         state.favorite_profile = None;
         state.entries = entries;
         drop(state);
+        self.update_mode_controls(BrowserMode::Favorites);
         self.search_entry.set_text("");
         self.render();
     }
 
+    fn show_recent(&self) {
+        self.cancel_listing();
+        self.edit_location_button.set_sensitive(false);
+        self.delete_location_button.set_sensitive(false);
+        self.path_entry.set_text("최근 열어본 파일");
+        self.path_entry.set_editable(false);
+        let entries = self
+            .config
+            .borrow()
+            .recent_files
+            .iter()
+            .map(recent_file_browser_entry)
+            .collect();
+        let mut state = self.state.borrow_mut();
+        state.generation = state.generation.wrapping_add(1);
+        state.typeahead_query.clear();
+        state.typeahead_last_input = None;
+        state.mode = BrowserMode::Recent;
+        state.favorite_profile = None;
+        state.entries = entries;
+        drop(state);
+        self.update_mode_controls(BrowserMode::Recent);
+        self.search_entry.set_text("");
+        self.render();
+    }
+
+    fn update_mode_controls(&self, mode: BrowserMode) {
+        let recent = mode == BrowserMode::Recent;
+        self.clear_recent_button.set_visible(recent);
+        self.sort_dropdown.set_sensitive(!recent);
+        self.direction_button.set_sensitive(!recent);
+    }
+
     fn open_favorite(self: &Rc<Self>, favorite: FavoriteEntry) {
         let Ok(root) = root_file(&favorite.profile) else {
             self.status_label
-                .set_text("즐겨찾기의 저장된 위치가 올바르지 않습니다.");
+                .set_text("저장된 파일의 위치 정보가 올바르지 않습니다.");
             return;
         };
         let favorite_file = gio::File::for_uri(&favorite.uri);
         if !is_within_root(&favorite_file, &root) {
             self.status_label
-                .set_text("즐겨찾기가 저장된 위치의 루트 밖을 가리킵니다.");
+                .set_text("저장된 파일이 위치의 루트 밖을 가리킵니다.");
             return;
         }
         if favorite.is_directory {
@@ -511,17 +574,18 @@ impl BrowserController {
             self.delete_location_button.set_sensitive(false);
             let mut state = self.state.borrow_mut();
             state.favorite_profile = Some(favorite.profile.clone());
-            state.browsing_favorites = false;
+            state.mode = BrowserMode::Directory;
             state.root_uri = root.uri().into();
             state.current_uri = favorite.uri;
             drop(state);
+            self.update_mode_controls(BrowserMode::Directory);
             self.search_entry.set_text("");
             self.refresh();
             return;
         }
 
         self.cancel_listing();
-        self.status_label.set_text("즐겨찾기에 연결하는 중...");
+        self.status_label.set_text("저장된 파일에 연결하는 중...");
         let operation = mount_operation(&favorite.profile, &self.window);
         let controller = Rc::downgrade(self);
         let task = glib::MainContext::default().spawn_local(async move {
@@ -554,7 +618,7 @@ impl BrowserController {
             if !kind.is_viewable() {
                 controller
                     .status_label
-                    .set_text("이 즐겨찾기 파일 형식은 열 수 없습니다.");
+                    .set_text("이 파일 형식은 열 수 없습니다.");
                 return;
             }
             let entry = folder_entries
@@ -591,8 +655,7 @@ impl BrowserController {
     }
 
     fn open_entered_path(self: &Rc<Self>) {
-        let browsing_favorites = self.state.borrow().browsing_favorites;
-        if browsing_favorites {
+        if self.state.borrow().mode != BrowserMode::Directory {
             return;
         }
         let profile = self.current_profile();
@@ -609,8 +672,7 @@ impl BrowserController {
     }
 
     fn go_up(self: &Rc<Self>) {
-        let browsing_favorites = self.state.borrow().browsing_favorites;
-        if browsing_favorites {
+        if self.state.borrow().mode != BrowserMode::Directory {
             return;
         }
         let state = self.state.borrow();
@@ -624,10 +686,17 @@ impl BrowserController {
     }
 
     fn refresh(self: &Rc<Self>) {
-        let browsing_favorites = self.state.borrow().browsing_favorites;
-        if browsing_favorites {
-            self.show_favorites();
-            return;
+        let mode = self.state.borrow().mode;
+        match mode {
+            BrowserMode::Favorites => {
+                self.show_favorites();
+                return;
+            }
+            BrowserMode::Recent => {
+                self.show_recent();
+                return;
+            }
+            BrowserMode::Directory => {}
         }
         self.cancel_listing();
         let (profile, uri, generation) = {
@@ -658,7 +727,8 @@ impl BrowserController {
                 let Some(controller) = progress_controller.upgrade() else {
                     return;
                 };
-                if controller.state.borrow().generation == generation {
+                let state = controller.state.borrow();
+                if state.generation == generation && state.mode == BrowserMode::Directory {
                     controller.status_label.set_text(&format!(
                         "폴더를 불러오는 중... ({count}개의 파일/폴더를 읽음)"
                     ));
@@ -669,7 +739,7 @@ impl BrowserController {
                 return;
             };
             let state = controller.state.borrow();
-            let stale = state.generation != generation || state.browsing_favorites;
+            let stale = state.generation != generation || state.mode != BrowserMode::Directory;
             drop(state);
             if stale {
                 return;
@@ -701,12 +771,14 @@ impl BrowserController {
             .filter(|entry| browser_search_match(entry, query.as_str()))
             .cloned()
             .collect();
-        sort_entries(
-            &mut visible_entries,
-            state.sort_field,
-            state.sort_direction,
-            case_insensitive,
-        );
+        if state.mode != BrowserMode::Recent {
+            sort_entries(
+                &mut visible_entries,
+                state.sort_field,
+                state.sort_direction,
+                case_insensitive,
+            );
+        }
         let count = visible_entries.len();
         let names = visible_entries
             .iter()
@@ -776,8 +848,11 @@ impl BrowserController {
         drop(state);
 
         if let Some(index) = found {
-            self.list_selection.set_selected(index as u32);
-            let _ = self.list_view.grab_focus();
+            self.list_view.scroll_to(
+                index as u32,
+                gtk::ListScrollFlags::FOCUS | gtk::ListScrollFlags::SELECT,
+                None,
+            );
             self.status_label.set_text(&format!(
                 "'{query}'로 이동: {}",
                 found_name.unwrap_or_default()
@@ -828,19 +903,40 @@ impl BrowserController {
         else {
             return;
         };
-        let browsing_favorites = self.state.borrow().browsing_favorites;
-        if browsing_favorites {
-            let favorite = self
-                .config
-                .borrow()
-                .favorites
-                .iter()
-                .find(|favorite| favorite.uri == entry.uri)
-                .cloned();
-            if let Some(favorite) = favorite {
-                self.open_favorite(favorite);
+        let mode = self.state.borrow().mode;
+        match mode {
+            BrowserMode::Favorites => {
+                let favorite = self
+                    .config
+                    .borrow()
+                    .favorites
+                    .iter()
+                    .find(|favorite| favorite.uri == entry.uri)
+                    .cloned();
+                if let Some(favorite) = favorite {
+                    self.open_favorite(favorite);
+                }
+                return;
             }
-            return;
+            BrowserMode::Recent => {
+                let recent = self
+                    .config
+                    .borrow()
+                    .recent_files
+                    .iter()
+                    .find(|recent| recent.uri == entry.uri)
+                    .cloned();
+                if let Some(recent) = recent {
+                    self.open_favorite(FavoriteEntry {
+                        name: recent.name,
+                        uri: recent.uri,
+                        is_directory: false,
+                        profile: recent.profile,
+                    });
+                }
+                return;
+            }
+            BrowserMode::Directory => {}
         }
         match entry.kind {
             EntryKind::Directory => {
@@ -985,9 +1081,9 @@ impl BrowserController {
             state.sort_direction,
             case_insensitive,
         );
-        let browsing_favorites = state.browsing_favorites;
+        let mode = state.mode;
         drop(state);
-        if !browsing_favorites && entries.iter().any(|entry| entry.uri == current_uri) {
+        if mode == BrowserMode::Directory && entries.iter().any(|entry| entry.uri == current_uri) {
             Rc::new(entries)
         } else {
             Rc::clone(fallback)
@@ -1001,6 +1097,8 @@ impl BrowserController {
         profile: LocationProfile,
         reuse_window: Option<gtk::ApplicationWindow>,
     ) {
+        let recent_entry = entry.clone();
+        let recent_profile = profile.clone();
         self.status_label.set_text("ZIP 파일 다운로드 준비 중...");
         let progress_label = reuse_window.as_ref().map_or_else(
             || self.status_label.clone(),
@@ -1027,6 +1125,7 @@ impl BrowserController {
                 }
                 match result {
                     Ok(source) => {
+                        controller.record_recent_file(&recent_entry, &recent_profile);
                         controller.status_label.set_text("다운로드 완료");
                         result_label.set_text("ZIP 파일을 여는 중...");
                         let Some(application) = controller.window.application() else {
@@ -1068,6 +1167,8 @@ impl BrowserController {
         profile: LocationProfile,
         reuse_window: Option<gtk::ApplicationWindow>,
     ) {
+        let recent_entry = entry.clone();
+        let recent_profile = profile.clone();
         let kind = entry.kind;
         self.status_label
             .set_text("미디어 파일 다운로드 준비 중...");
@@ -1096,6 +1197,7 @@ impl BrowserController {
                 }
                 match result {
                     Ok(source) => {
+                        controller.record_recent_file(&recent_entry, &recent_profile);
                         controller.status_label.set_text("다운로드 완료");
                         result_label.set_text("미디어 파일을 여는 중...");
                         let Some(application) = controller.window.application() else {
@@ -1208,16 +1310,32 @@ impl BrowserController {
     }
 
     fn profile_for_entry(&self, entry: &BrowserEntry) -> LocationProfile {
-        if self.state.borrow().browsing_favorites
-            && let Some(profile) = self
-                .config
-                .borrow()
-                .favorites
-                .iter()
-                .find(|favorite| favorite.uri == entry.uri)
-                .map(|favorite| favorite.profile.clone())
-        {
-            return profile;
+        match self.state.borrow().mode {
+            BrowserMode::Favorites => {
+                if let Some(profile) = self
+                    .config
+                    .borrow()
+                    .favorites
+                    .iter()
+                    .find(|favorite| favorite.uri == entry.uri)
+                    .map(|favorite| favorite.profile.clone())
+                {
+                    return profile;
+                }
+            }
+            BrowserMode::Recent => {
+                if let Some(profile) = self
+                    .config
+                    .borrow()
+                    .recent_files
+                    .iter()
+                    .find(|recent| recent.uri == entry.uri)
+                    .map(|recent| recent.profile.clone())
+                {
+                    return profile;
+                }
+            }
+            BrowserMode::Directory => {}
         }
         self.current_profile()
     }
@@ -1449,13 +1567,14 @@ impl BrowserController {
         let uri: String = directory.uri().into();
         let mut state = self.state.borrow_mut();
         state.favorite_profile = Some(profile);
-        state.browsing_favorites = false;
+        state.mode = BrowserMode::Directory;
         state.root_uri = uri.clone();
         state.current_uri = uri.clone();
         state.entries = entries;
         state.typeahead_query.clear();
         state.typeahead_last_input = None;
         drop(state);
+        self.update_mode_controls(BrowserMode::Directory);
         self.path_entry.set_text(&display_uri(&uri));
         self.search_entry.set_text("");
         self.render();
@@ -1525,8 +1644,7 @@ impl BrowserController {
             return was_active;
         }
         *self.config.borrow_mut() = updated;
-        let browsing_favorites = self.state.borrow().browsing_favorites;
-        if browsing_favorites {
+        if self.state.borrow().mode == BrowserMode::Favorites {
             self.show_favorites();
         }
         self.status_label.set_text(if active {
@@ -1537,6 +1655,28 @@ impl BrowserController {
         active
     }
 
+    fn record_recent_file(&self, entry: &BrowserEntry, profile: &LocationProfile) {
+        let mut updated = self.config.borrow().clone();
+        record_recent_file(&mut updated, entry, profile);
+        if let Err(error) = updated.save(&self.config_path) {
+            self.status_label
+                .set_text(&format!("최근 파일 기록을 저장할 수 없습니다: {error:#}"));
+            return;
+        }
+        *self.config.borrow_mut() = updated;
+        if self.state.borrow().mode == BrowserMode::Recent {
+            let entries = self
+                .config
+                .borrow()
+                .recent_files
+                .iter()
+                .map(recent_file_browser_entry)
+                .collect();
+            self.state.borrow_mut().entries = entries;
+            self.render();
+        }
+    }
+
     fn choose_download_destination(
         self: &Rc<Self>,
         entry: BrowserEntry,
@@ -1973,6 +2113,58 @@ impl BrowserController {
         });
         dialog.present();
     }
+
+    fn show_clear_recent_dialog(self: &Rc<Self>) {
+        let dialog = gtk::Window::builder()
+            .title("최근 기록 비우기")
+            .transient_for(&self.window)
+            .modal(true)
+            .resizable(false)
+            .default_width(420)
+            .build();
+        let content = gtk::Box::new(gtk::Orientation::Vertical, 16);
+        content.set_margin_top(18);
+        content.set_margin_bottom(12);
+        content.set_margin_start(18);
+        content.set_margin_end(18);
+        let message = gtk::Label::new(Some(
+            "최근 열어본 파일 기록을 모두 삭제하시겠습니까?\n즐겨찾기와 ZIP 읽기 진행도는 유지됩니다.",
+        ));
+        message.set_wrap(true);
+        message.set_xalign(0.0);
+        let actions = gtk::Box::new(gtk::Orientation::Horizontal, 6);
+        actions.set_halign(gtk::Align::End);
+        let cancel_button = gtk::Button::with_label("취소");
+        let clear_button = gtk::Button::with_label("모두 삭제");
+        clear_button.add_css_class("destructive-action");
+        actions.append(&cancel_button);
+        actions.append(&clear_button);
+        content.append(&message);
+        content.append(&actions);
+        dialog.set_child(Some(&content));
+
+        let dialog_to_close = dialog.clone();
+        cancel_button.connect_clicked(move |_| dialog_to_close.close());
+        let controller = Rc::clone(self);
+        let dialog_to_close = dialog.clone();
+        clear_button.connect_clicked(move |_| {
+            let mut updated = controller.config.borrow().clone();
+            updated.recent_files.clear();
+            if let Err(error) = updated.save(&controller.config_path) {
+                controller
+                    .status_label
+                    .set_text(&format!("최근 기록을 삭제할 수 없습니다: {error:#}"));
+                return;
+            }
+            *controller.config.borrow_mut() = updated;
+            controller.show_recent();
+            controller
+                .status_label
+                .set_text("최근 기록을 삭제했습니다.");
+            dialog_to_close.close();
+        });
+        dialog.present();
+    }
 }
 
 fn install_latest_update() -> Result<()> {
@@ -2258,8 +2450,15 @@ fn browser_search_match(entry: &BrowserEntry, lowercase_query: &str) -> bool {
     lowercase_query.is_empty() || entry.name.to_lowercase().contains(lowercase_query)
 }
 
-fn is_favorites_selection(selected: u32, profile_count: usize) -> bool {
-    selected != gtk::INVALID_LIST_POSITION && selected as usize == profile_count
+fn special_browser_mode(selected: u32, profile_count: usize) -> Option<BrowserMode> {
+    if selected == gtk::INVALID_LIST_POSITION {
+        return None;
+    }
+    match selected as usize {
+        index if index == profile_count => Some(BrowserMode::Favorites),
+        index if index == profile_count + 1 => Some(BrowserMode::Recent),
+        _ => None,
+    }
 }
 
 fn sorted_navigable_entries(
@@ -2313,6 +2512,32 @@ fn favorite_browser_entry(favorite: &FavoriteEntry) -> BrowserEntry {
     }
 }
 
+fn recent_file_browser_entry(recent: &RecentFileEntry) -> BrowserEntry {
+    BrowserEntry {
+        uri: recent.uri.clone(),
+        name: recent.name.clone(),
+        list_name: None,
+        kind: classify_file(Path::new(&recent.name)),
+        size: None,
+        modified: None,
+        created: None,
+        etag: None,
+    }
+}
+
+fn record_recent_file(config: &mut AppConfig, entry: &BrowserEntry, profile: &LocationProfile) {
+    config.recent_files.retain(|recent| recent.uri != entry.uri);
+    config.recent_files.insert(
+        0,
+        RecentFileEntry {
+            name: entry.name.clone(),
+            uri: entry.uri.clone(),
+            profile: profile.clone(),
+        },
+    );
+    config.recent_files.truncate(RECENT_FILE_LIMIT);
+}
+
 fn show_viewer_loading(
     window: &gtk::ApplicationWindow,
     file_name: &str,
@@ -2603,9 +2828,62 @@ mod tests {
 
         assert_eq!(folder.kind, EntryKind::Directory);
         assert_eq!(archive.kind, EntryKind::ZipArchive);
-        assert!(is_favorites_selection(3, 3));
-        assert!(!is_favorites_selection(2, 3));
-        assert!(!is_favorites_selection(gtk::INVALID_LIST_POSITION, 3));
+        assert_eq!(special_browser_mode(3, 3), Some(BrowserMode::Favorites));
+        assert_eq!(special_browser_mode(4, 3), Some(BrowserMode::Recent));
+        assert_eq!(special_browser_mode(2, 3), None);
+        assert_eq!(special_browser_mode(gtk::INVALID_LIST_POSITION, 3), None);
+    }
+
+    #[test]
+    fn recent_files_move_to_front_and_keep_only_100() {
+        let profile = LocationProfile {
+            name: "원격".into(),
+            kind: LocationKind::Sftp,
+            address: "sftp://example.invalid/comics".into(),
+            username: "reader".into(),
+            password: "password".into(),
+            domain: String::new(),
+        };
+        let mut config = AppConfig::default();
+        for index in 0..=RECENT_FILE_LIMIT {
+            let entry = media_entry(&format!("page{index}.jpg"));
+            record_recent_file(&mut config, &entry, &profile);
+        }
+        assert_eq!(config.recent_files.len(), RECENT_FILE_LIMIT);
+        assert_eq!(config.recent_files[0].name, "page100.jpg");
+        assert!(
+            !config
+                .recent_files
+                .iter()
+                .any(|recent| recent.name == "page0.jpg")
+        );
+
+        let entry = media_entry("page50.jpg");
+        record_recent_file(&mut config, &entry, &profile);
+        assert_eq!(config.recent_files.len(), RECENT_FILE_LIMIT);
+        assert_eq!(config.recent_files[0].name, "page50.jpg");
+        assert_eq!(config.recent_files[0].profile.password, "password");
+    }
+
+    #[test]
+    fn recent_files_support_all_viewer_file_types() {
+        let profile = home_profile();
+        let mut config = AppConfig::default();
+        for name in ["book.zip", "page.jpg", "clip.mp4"] {
+            let mut entry = media_entry(name);
+            entry.kind = classify_file(Path::new(name));
+            record_recent_file(&mut config, &entry, &profile);
+        }
+        let kinds = config
+            .recent_files
+            .iter()
+            .map(recent_file_browser_entry)
+            .map(|entry| entry.kind)
+            .collect::<Vec<_>>();
+        assert_eq!(
+            kinds,
+            [EntryKind::Video, EntryKind::Image, EntryKind::ZipArchive]
+        );
     }
 
     #[test]