fix: Ctrl+R flip also matches the physical R key (v1.6.1)

On some keymaps the R key resolves to a different logical key (observed on a
Turkish remote-desktop setup: the R key arrives as logical T), so the Ctrl+R
shortcut never fired even though the key events reached the app. The shortcut
now matches PhysicalKeyboardKey.keyR as well; a regression test covers the
wrong-layout case.

.gitignore

@@ -49,7 +49,7 @@ app.*.map.json
 *.deb
 *.tar.gz
 *.exe
-!dist/imajviewer_1.5.0_amd64.deb
+!dist/imajviewer_1.6.1_amd64.deb
 !dist/imajviewer_setup_1.1.0.exe
 deb/usr/lib/imajviewer/
 release/

CHANGELOG.md

@@ -4,6 +4,22 @@ All notable changes to imajViewer are documented in this file.
 
 ## [Unreleased]
 
+## [1.6.1] - 2026-10-14
+
+### Fixed
+- Horizontal flip shortcut (`Ctrl+R`) never fired when the keyboard layout resolves the R key to a
+  different logical key (reported with a Turkish/remote-desktop setup where the R key arrives as
+  logical `T`). The shortcut now matches the physical R key position as well.
+
+## [1.6.0] - 2026-10-14
+
+### Added
+- Horizontal flip (`Ctrl+R`): mirrors the image left-right about the viewport centre and clears
+  the active effects (same reset as double right click); pressing `Ctrl+R` again restores the
+  original orientation. Zoom/pan are kept.
+- Crop save (`Ctrl+S`) now bakes the flip into the output as well, so the saved JPEG matches
+  the mirrored view (also in combination with rotation).
+
 ## [1.5.0] - 2026-10-12
 
 ### Added

README.md

@@ -18,14 +18,17 @@ Ultra-lightweight image viewer written in Flutter — Linux & Windows.
 - **Saturation:** Ctrl + Right drag + vertical move
 - **Brightness:** Ctrl+Shift + Right drag + vertical move
 - **Rotate:** Shift + Right drag + vertical move (~100px = 90°)
+- **Flip horizontally:** `Ctrl+R` — mirrors the view and clears the active effects (same reset as
+  double right click); press `Ctrl+R` again to undo. Also matches the physical R key position, so
+  keymaps that report the R key as a different character still work
 - **Reset (all effects):** Double right click
 - **Navigation arrows:** bottom corners, visible on hover
 - **Settings (gear):** sort by time/name, print, shortcut info
 - **Print:** send the image to a printer (A4, fit)
 - **Save visible area:** title bar save icon or `Ctrl+S` — the on-screen region is written at
   original resolution as JPEG (quality 93) next to the source file (`photo.jpg` →
-  `photo_143025.jpg`); active effects (contrast/saturation/brightness) and rotation are baked
-  into the output; if that name already exists, nothing is written and a warning is shown
+  `photo_143025.jpg`); active effects (contrast/saturation/brightness), rotation and horizontal
+  flip are baked into the output; if that name already exists, nothing is written and a warning is shown
 - Drag & drop to open images
 - Window size/position memory (JSON persistence)
 - Set as default image viewer
@@ -86,6 +89,7 @@ folder including `imajviewer.exe` and all DLLs).
 | Ctrl + Right drag + vertical | Saturation (0.0 – 2.0) |
 | Ctrl+Shift + Right drag + vertical | Brightness (-100 – 100) |
 | Shift + Right drag + vertical | Rotate (free) |
+| Ctrl + R | Flip horizontally (clears effects; press again to undo) |
 | Double right click | Reset (all effects) |
 | Left / Right arrow | Previous / next image |
 | Ctrl + S | Save visible area (JPEG 93, original resolution) |

lib/l10n/app_en.arb

@@ -6,7 +6,7 @@
   "sortByName": "By name",
   "appDescription": "Ultra-lightweight and fast image viewer. Open images and use arrows or keyboard keys to navigate.",
   "shortcuts": "Shortcuts",
-  "shortcutsList": "• Left/Right arrow — previous/next image\n• Ctrl+S — save visible area (JPEG 93)\n• Ctrl+Q — close window\n• Ctrl+Shift+Q — close all windows\n• Double click — toggle fill/fit\n• Right-drag — contrast\n• Shift+right-drag — rotate\n• Ctrl+right-drag — saturation\n• Ctrl+Shift+right-drag — brightness",
+  "shortcutsList": "• Left/Right arrow — previous/next image\n• Ctrl+S — save visible area (JPEG 93)\n• Ctrl+R — flip horizontally (clears effects, press again to undo)\n• Ctrl+Q — close window\n• Ctrl+Shift+Q — close all windows\n• Double click — toggle fill/fit\n• Right-drag — contrast\n• Shift+right-drag — rotate\n• Ctrl+right-drag — saturation\n• Ctrl+Shift+right-drag — brightness",
   "print": "Print",
   "close": "Close",
   "saveCrop": "Save visible area (JPEG 93)",

lib/l10n/app_localizations.dart

@@ -137,7 +137,7 @@ abstract class AppLocalizations {
   /// No description provided for @shortcutsList.
   ///
   /// In en, this message translates to:
-  /// **'• Left/Right arrow — previous/next image\n• Ctrl+S — save visible area (JPEG 93)\n• Ctrl+Q — close window\n• Ctrl+Shift+Q — close all windows\n• Double click — toggle fill/fit\n• Right-drag — contrast\n• Shift+right-drag — rotate\n• Ctrl+right-drag — saturation\n• Ctrl+Shift+right-drag — brightness'**
+  /// **'• Left/Right arrow — previous/next image\n• Ctrl+S — save visible area (JPEG 93)\n• Ctrl+R — flip horizontally (clears effects, press again to undo)\n• Ctrl+Q — close window\n• Ctrl+Shift+Q — close all windows\n• Double click — toggle fill/fit\n• Right-drag — contrast\n• Shift+right-drag — rotate\n• Ctrl+right-drag — saturation\n• Ctrl+Shift+right-drag — brightness'**
   String get shortcutsList;
 
   /// No description provided for @print.

lib/l10n/app_localizations_en.dart

@@ -29,7 +29,7 @@ class AppLocalizationsEn extends AppLocalizations {
 
   @override
   String get shortcutsList =>
-      '• Left/Right arrow — previous/next image\n• Ctrl+S — save visible area (JPEG 93)\n• Ctrl+Q — close window\n• Ctrl+Shift+Q — close all windows\n• Double click — toggle fill/fit\n• Right-drag — contrast\n• Shift+right-drag — rotate\n• Ctrl+right-drag — saturation\n• Ctrl+Shift+right-drag — brightness';
+      '• Left/Right arrow — previous/next image\n• Ctrl+S — save visible area (JPEG 93)\n• Ctrl+R — flip horizontally (clears effects, press again to undo)\n• Ctrl+Q — close window\n• Ctrl+Shift+Q — close all windows\n• Double click — toggle fill/fit\n• Right-drag — contrast\n• Shift+right-drag — rotate\n• Ctrl+right-drag — saturation\n• Ctrl+Shift+right-drag — brightness';
 
   @override
   String get print => 'Print';

lib/l10n/app_localizations_tr.dart

@@ -29,7 +29,7 @@ class AppLocalizationsTr extends AppLocalizations {
 
   @override
   String get shortcutsList =>
-      '• Sol/Sağ ok — önceki/sonraki resim\n• Ctrl+S — görünen alanı kaydet (JPEG 93)\n• Ctrl+Q — pencereyi kapat\n• Ctrl+Shift+Q — tüm pencereleri kapat\n• Çift tık — doldur/sığdır geçişi\n• Sağ tık sürükle — kontrast\n• Shift+sağ tık — döndür\n• Ctrl+sağ tık — doygunluk\n• Ctrl+Shift+sağ tık — parlaklık';
+      '• Sol/Sağ ok — önceki/sonraki resim\n• Ctrl+S — görünen alanı kaydet (JPEG 93)\n• Ctrl+R — yatay aynala (efektleri sıfırlar, tekrar basınca geri alır)\n• Ctrl+Q — pencereyi kapat\n• Ctrl+Shift+Q — tüm pencereleri kapat\n• Çift tık — doldur/sığdır geçişi\n• Sağ tık sürükle — kontrast\n• Shift+sağ tık — döndür\n• Ctrl+sağ tık — doygunluk\n• Ctrl+Shift+sağ tık — parlaklık';
 
   @override
   String get print => 'Yazdır';

lib/l10n/app_tr.arb

@@ -6,7 +6,7 @@
   "sortByName": "İsme göre",
   "appDescription": "Ultra hafif ve hızlı resim görüntüleyici. Görselleri açın, gezinti için okları veya klavye tuşlarını kullanın.",
   "shortcuts": "Kısayollar",
-  "shortcutsList": "• Sol/Sağ ok — önceki/sonraki resim\n• Ctrl+S — görünen alanı kaydet (JPEG 93)\n• Ctrl+Q — pencereyi kapat\n• Ctrl+Shift+Q — tüm pencereleri kapat\n• Çift tık — doldur/sığdır geçişi\n• Sağ tık sürükle — kontrast\n• Shift+sağ tık — döndür\n• Ctrl+sağ tık — doygunluk\n• Ctrl+Shift+sağ tık — parlaklık",
+  "shortcutsList": "• Sol/Sağ ok — önceki/sonraki resim\n• Ctrl+S — görünen alanı kaydet (JPEG 93)\n• Ctrl+R — yatay aynala (efektleri sıfırlar, tekrar basınca geri alır)\n• Ctrl+Q — pencereyi kapat\n• Ctrl+Shift+Q — tüm pencereleri kapat\n• Çift tık — doldur/sığdır geçişi\n• Sağ tık sürükle — kontrast\n• Shift+sağ tık — döndür\n• Ctrl+sağ tık — doygunluk\n• Ctrl+Shift+sağ tık — parlaklık",
   "print": "Yazdır",
   "close": "Kapat",
   "saveCrop": "Görünen alanı kaydet (JPEG 93)",

lib/screens/viewer_screen.dart

@@ -190,6 +190,8 @@ class _ViewerScreenState extends State<ViewerScreen> with WindowListener {
     );
   }
 
+  void _flipHorizontal() => _canvasKey.currentState?.toggleFlipH();
+
   Future<void> _cropSave() async {
     final path = ImageManager.instance.currentImagePath;
     final state = _canvasKey.currentState;
@@ -237,6 +239,7 @@ class _ViewerScreenState extends State<ViewerScreen> with WindowListener {
   Widget build(BuildContext context) {
     return AppShortcuts(
       onCropSave: _hasImages ? _cropSave : null,
+      onFlipH: _hasImages ? _flipHorizontal : null,
       child: Scaffold(
         backgroundColor: Colors.transparent,
         body: WindowResizeZones(

lib/services/crop_save_service.dart

@@ -17,6 +17,7 @@ class CropViewParams {
   final double vw, vh; // viewport boyutu
   final double tx, ty, sc; // pan/zoom
   final double angleDeg; // donus (derece)
+  final bool flipH; // yatay aynalama (goruntunun kendisi degil, gorunum)
   final double cx, cy; // donus merkezi (viewport ortasi)
   final double k; // kaynak -> layout olcegi
   final double ox, oy; // layout offset
@@ -29,6 +30,7 @@ class CropViewParams {
     required this.ty,
     required this.sc,
     required this.angleDeg,
+    this.flipH = false,
     required this.cx,
     required this.cy,
     required this.k,
@@ -73,6 +75,8 @@ class CropSaveService {
     final out = vp.angleDeg == 0
         ? _cropAxisAligned(source, vp)
         : _cropRotated(source, vp);
+    // Ekranda yatay aynalama acikken cikti da aynalanir (cikti = viewport'un birebir eslemesi).
+    if (vp.flipH) img.flipHorizontal(out);
     // Çıktıda yön fiziksel — EXIF tag'ini temizle (çift dönüşü önler).
     out.exif.imageIfd.orientation = null;
 

lib/shortcuts/app_shortcuts.dart

@@ -8,8 +8,14 @@ import '../services/file_handler.dart';
 class AppShortcuts extends StatelessWidget {
   final Widget child;
   final VoidCallback? onCropSave;
+  final VoidCallback? onFlipH;
 
-  const AppShortcuts({super.key, required this.child, this.onCropSave});
+  const AppShortcuts({
+    super.key,
+    required this.child,
+    this.onCropSave,
+    this.onFlipH,
+  });
 
   @override
   Widget build(BuildContext context) {
@@ -44,6 +50,17 @@ class AppShortcuts extends StatelessWidget {
             }
           }
 
+          // Ctrl+R: yatay aynala / geri al (fiziksel R: bazi klavye haritalarinda
+          // mantiksal tus T gibi farkli cozuluyor)
+          if (ctrl &&
+              (event.logicalKey == LogicalKeyboardKey.keyR ||
+                  event.physicalKey == PhysicalKeyboardKey.keyR)) {
+            if (onFlipH != null) {
+              onFlipH!();
+              return KeyEventResult.handled;
+            }
+          }
+
           switch (event.logicalKey) {
             case LogicalKeyboardKey.arrowLeft:
               ImageManager.instance.previousImage();

lib/widgets/image_canvas.dart

@@ -26,6 +26,7 @@ class ImageCanvasState extends State<ImageCanvas> {
   double _contrast = 1.0;
   double _saturation = 1.0;
   double _brightness = 0;
+  bool _flipH = false;
 
   // ── Gesture tracking ──
   String _interactionMode = 'none'; // 'contrast' | 'rotate' | 'saturation' | 'brightness'
@@ -202,6 +203,7 @@ class ImageCanvasState extends State<ImageCanvas> {
   void _resetView() {
     _tx = 0; _ty = 0; _sc = 1.0; _isFilled = WindowPersistence.filled;
     _angle = 0; _contrast = 1.0; _saturation = 1.0; _brightness = 0;
+    _flipH = false;
     _usingFullRes = false;
     _imageSize = Size.zero;
     _markRenderDirty();
@@ -210,10 +212,19 @@ class ImageCanvasState extends State<ImageCanvas> {
   void _toggleFillFit() {
     _isFilled = !_isFilled; _tx = 0; _ty = 0; _sc = 1.0;
     _angle = 0; _contrast = 1.0; _saturation = 1.0; _brightness = 0;
+    _flipH = false;
     WindowPersistence.saveFilled(_isFilled);
     _markRenderDirty();
   }
 
+  /// Ctrl+R: sağ çift tık gibi efektleri sıfırlar ve yatay aynalar; tekrar basınca geri alır.
+  void toggleFlipH() {
+    _flipH = !_flipH;
+    _angle = 0; _contrast = 1.0; _saturation = 1.0; _brightness = 0;
+    _interactionMode = 'none';
+    _markRenderDirty();
+  }
+
   void _handleDoubleTap() => _toggleFillFit();
 
   void _handleScroll(PointerScrollEvent e) {
@@ -261,6 +272,7 @@ class ImageCanvasState extends State<ImageCanvas> {
       _contrast = 1.0;
       _saturation = 1.0;
       _brightness = 0;
+      _flipH = false;
       _interactionMode = 'none';
       _markRenderDirty();
       _lastRightTapTime = null;
@@ -416,6 +428,7 @@ class ImageCanvasState extends State<ImageCanvas> {
       ty: _ty,
       sc: _sc,
       angleDeg: _angle,
+      flipH: _flipH,
       cx: _vpSize.width / 2,
       cy: _vpSize.height / 2,
       k: k,
@@ -518,12 +531,13 @@ class ImageCanvasState extends State<ImageCanvas> {
       },
     );
 
-    if (_angle != 0) {
+    if (_angle != 0 || _flipH) {
       imageContent = Transform(
         alignment: Alignment.topLeft,
         transform: Matrix4.identity()
           ..translate(vpCenterX, vpCenterY)
           ..rotateZ(angleRad)
+          ..scale(_flipH ? -1.0 : 1.0, 1.0)
           ..translate(-vpCenterX, -vpCenterY),
         child: imageContent,
       );

pubspec.yaml

@@ -1,7 +1,7 @@
 name: imajviewer
 description: "Ultra-lightweight image viewer for Linux and Windows."
 publish_to: 'none'
-version: 1.5.0+11
+version: 1.6.1+13
 
 msix_config:
   display_name: ImajViewer

test/flip_test.dart

@@ -0,0 +1,93 @@
+import 'dart:io';
+
+import 'package:flutter/material.dart';
+import 'package:flutter/services.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:image/image.dart' as img;
+import 'package:imajviewer/shortcuts/app_shortcuts.dart';
+import 'package:imajviewer/widgets/image_canvas.dart';
+
+/// Aynalama uygulandiginda render zincirinde negatif x olcekli bir Transform bulunur.
+bool _mirrored(WidgetTester tester) => tester
+    .widgetList<Transform>(find.byType(Transform))
+    .any((t) => t.transform.entry(0, 0) < 0);
+
+Future<void> _pressCtrlR(WidgetTester tester) async {
+  await tester.sendKeyDownEvent(LogicalKeyboardKey.controlLeft);
+  await tester.sendKeyDownEvent(LogicalKeyboardKey.keyR);
+  await tester.pump();
+  await tester.sendKeyUpEvent(LogicalKeyboardKey.keyR);
+  await tester.sendKeyUpEvent(LogicalKeyboardKey.controlLeft);
+  await tester.pump();
+  await tester.pump();
+}
+
+Future<void> _pressCtrlRWrongLayout(WidgetTester tester) async {
+  await tester.sendKeyDownEvent(LogicalKeyboardKey.controlLeft);
+  await tester.sendKeyDownEvent(LogicalKeyboardKey.keyT,
+      physicalKey: PhysicalKeyboardKey.keyR);
+  await tester.pump();
+  await tester.sendKeyUpEvent(LogicalKeyboardKey.keyT,
+      physicalKey: PhysicalKeyboardKey.keyR);
+  await tester.sendKeyUpEvent(LogicalKeyboardKey.controlLeft);
+  await tester.pump();
+  await tester.pump();
+}
+
+Widget _app(GlobalKey<ImageCanvasState> key, String path, double w, double h) {
+  return MaterialApp(
+    home: AppShortcuts(
+      onFlipH: () => key.currentState?.toggleFlipH(),
+      child: SizedBox(width: w, height: h, child: ImageCanvas(key: key, filePath: path)),
+    ),
+  );
+}
+
+void main() {
+  late Directory tmp;
+  late String pngPath;
+
+  setUpAll(() {
+    tmp = Directory.systemTemp.createTempSync('flip_test');
+    pngPath = '${tmp.path}/a.png';
+    File(pngPath).writeAsBytesSync(img.encodePng(img.Image(width: 4, height: 2))!);
+  });
+
+  tearDownAll(() => tmp.deleteSync(recursive: true));
+
+  testWidgets('Ctrl+R yatay aynalamayi acar, tekrar basinca kapatir', (tester) async {
+    final key = GlobalKey<ImageCanvasState>();
+    await tester.pumpWidget(_app(key, pngPath, 400, 300));
+    await tester.pump();
+
+    expect(_mirrored(tester), isFalse, reason: 'baslangicta aynalama olmamali');
+
+    await _pressCtrlR(tester);
+    expect(_mirrored(tester), isTrue, reason: 'Ctrl+R sonrasi aynalama acik olmali');
+
+    await _pressCtrlR(tester);
+    expect(_mirrored(tester), isFalse, reason: 'ikinci Ctrl+R sonrasi eski haline donmeli');
+  });
+
+  testWidgets('Ctrl+R crop-save parametrelerine aynalamayi tasir', (tester) async {
+    final key = GlobalKey<ImageCanvasState>();
+    await tester.pumpWidget(_app(key, pngPath, 100, 50));
+    await tester.pump();
+    await _pressCtrlR(tester);
+    final vp = key.currentState!.cropViewParams(4, 2);
+    expect(vp?.flipH, isTrue, reason: 'crop-save aynalamayi almali');
+  });
+
+  testWidgets('fiziksel R tusu mantiksal T olarak gelse de Ctrl+R calisir', (tester) async {
+    final key = GlobalKey<ImageCanvasState>();
+    await tester.pumpWidget(_app(key, pngPath, 400, 300));
+    await tester.pump();
+
+    await _pressCtrlRWrongLayout(tester);
+    expect(_mirrored(tester), isTrue,
+        reason: 'klavye haritasi R tusunu T olarak cozse bile aynalama acilmali');
+
+    await _pressCtrlRWrongLayout(tester);
+    expect(_mirrored(tester), isFalse, reason: 'tekrar basinca geri donmeli');
+  });
+}

tool/crop_test.dart

@@ -67,6 +67,38 @@ Future<void> main() async {
   print('3) dims ${r3.width}x${r3.height} (25x25 beklenir: zoom x2 + fill k=2 -> 4 src px/ekran px)');
   if (r3.width != 25 || r3.height != 25) fails++;
 
+  // 4) Yatay aynalama (flipH): gorunum aynalanir, cikti da aynali olmali
+  final out4 = '${tmp.path}/d';
+  Directory(out4).createSync();
+  final f4 = '$out4/src.jpg';
+  File(f4).writeAsBytesSync(File(srcPath).readAsBytesSync());
+  final p4 = CropViewParams(w: 100, h: 50, vw: 100, vh: 50, tx: 0, ty: 0, sc: 1,
+      angleDeg: 0, flipH: true, cx: 50, cy: 25, k: 1, ox: 0, oy: 0);
+  final path4 = await CropSaveService.saveCrop(srcPath: f4, source: await CropSaveService.load(f4), vp: p4);
+  final r4 = img.decodeImage(File(path4).readAsBytesSync())!;
+  print('4) dims ${r4.width}x${r4.height} (100x50 beklenir)');
+  if (r4.width != 100 || r4.height != 50) fails++;
+  checkPix('4) sol-ust (orij sag-ust YESIL)', imgPx(r4, 2, 2), 0, 255, 0);
+  checkPix('4) sag-ust (orij sol-ust KIRMIZI)', imgPx(r4, 97, 2), 255, 0, 0);
+  checkPix('4) sol-alt (orij sag-alt SARI)', imgPx(r4, 2, 47), 255, 255, 0);
+  checkPix('4) sag-alt (orij sol-alt MAVI)', imgPx(r4, 97, 47), 0, 0, 255);
+
+  // 5) Donus + aynalama: 2. senaryonun aynasi
+  final out5 = '${tmp.path}/e';
+  Directory(out5).createSync();
+  final f5 = '$out5/src.jpg';
+  File(f5).writeAsBytesSync(File(srcPath).readAsBytesSync());
+  final p5 = CropViewParams(w: 100, h: 50, vw: 50, vh: 100, tx: 0, ty: 0, sc: 1,
+      angleDeg: 90, flipH: true, cx: 25, cy: 50, k: 1, ox: -25, oy: 25);
+  final path5 = await CropSaveService.saveCrop(srcPath: f5, source: await CropSaveService.load(f5), vp: p5);
+  final r5 = img.decodeImage(File(path5).readAsBytesSync())!;
+  print('5) dims ${r5.width}x${r5.height} (50x100 beklenir)');
+  if (r5.width != 50 || r5.height != 100) fails++;
+  checkPix('5) sol-ust (orij sol-ust KIRMIZI)', imgPx(r5, 2, 2), 255, 0, 0);
+  checkPix('5) sag-ust (orij sol-alt MAVI)', imgPx(r5, 47, 2), 0, 0, 255);
+  checkPix('5) sol-alt (orij sag-ust YESIL)', imgPx(r5, 2, 97), 0, 255, 0);
+  checkPix('5) sag-alt (orij sag-alt SARI)', imgPx(r5, 47, 97), 255, 255, 0);
+
   tmp.deleteSync(recursive: true);
   print(fails == 0 ? 'ALL PASS' : '$fails FAILURES');
   exitCode = fails == 0 ? 0 : 1;