solareclipseworkbench 1.10.7__tar.gz → 2.0.0rc2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (125) hide show
  1. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/PKG-INFO +48 -57
  2. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/README.md +47 -56
  3. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/pyproject.toml +1 -1
  4. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/camera.py +935 -623
  5. solareclipseworkbench-2.0.0rc2/src/solareclipseworkbench/configuration.py +2 -0
  6. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/deltat.csv +1 -1
  7. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/gui.py +376 -157
  8. solareclipseworkbench-2.0.0rc2/src/solareclipseworkbench/hardware_problems.py +143 -0
  9. solareclipseworkbench-2.0.0rc2/src/solareclipseworkbench/img/live.png +0 -0
  10. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/notifications.py +35 -2
  11. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/utils.py +27 -6
  12. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench.egg-info/PKG-INFO +48 -57
  13. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench.egg-info/SOURCES.txt +6 -2
  14. solareclipseworkbench-2.0.0rc2/tests/test_hardware_problems.py +78 -0
  15. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/tests/test_sony_burst.py +16 -10
  16. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/tests/test_sony_storageinfo.py +6 -7
  17. solareclipseworkbench-2.0.0rc2/tests/test_voice_prompt_validation.py +60 -0
  18. solareclipseworkbench-1.10.7/tests/test_sony_save_destination.py +0 -28
  19. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/LICENSE +0 -0
  20. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/setup.cfg +0 -0
  21. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/__init__.py +0 -0
  22. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/__main__.py +0 -0
  23. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/besselian_element_generator.py +0 -0
  24. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/commands.py +0 -0
  25. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/constants.py +0 -0
  26. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/eclipse_besselian.csv +0 -0
  27. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/example_scripts/20240408.txt +0 -0
  28. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/example_scripts/20250329.txt +0 -0
  29. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/example_scripts/__init__.py +0 -0
  30. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/example_scripts/test.txt +0 -0
  31. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/example_scripts/testEOS1000D.txt +0 -0
  32. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/example_scripts/testEOS80D.txt +0 -0
  33. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/example_scripts/testEOSR.txt +0 -0
  34. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/example_scripts/testNikon.txt +0 -0
  35. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/example_scripts/testSony.txt +0 -0
  36. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/example_scripts/testVirtualCamera.txt +0 -0
  37. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/example_scripts/voice_prompts.txt +0 -0
  38. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/example_scripts/voice_prompts_basic.txt +0 -0
  39. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/exposure_calculator.py +0 -0
  40. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/img/__init__.py +0 -0
  41. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/img/astrowimsara.jpg +0 -0
  42. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/img/calendar.png +0 -0
  43. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/img/camera.png +0 -0
  44. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/img/clock.png +0 -0
  45. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/img/datetime-format-popup.png +0 -0
  46. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/img/eclipse-date-popup.png +0 -0
  47. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/img/folder.png +0 -0
  48. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/img/location-popup.png +0 -0
  49. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/img/location.png +0 -0
  50. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/img/logo-small.jpg +0 -0
  51. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/img/logo-small.svg +0 -0
  52. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/img/logo.jpg +0 -0
  53. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/img/refresh.png +0 -0
  54. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/img/save.png +0 -0
  55. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/img/settings.png +0 -0
  56. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/img/simulation-popup.png +0 -0
  57. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/img/simulator.png +0 -0
  58. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/img/stop.png +0 -0
  59. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/img/toolbar.png +0 -0
  60. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/img/ui-top.png +0 -0
  61. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/location.py +0 -0
  62. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/location_ui.py +0 -0
  63. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/nutation.py +0 -0
  64. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/observer.py +0 -0
  65. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/phone_gps.py +0 -0
  66. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/qt_utils.py +0 -0
  67. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/reference_moments.py +0 -0
  68. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/scripts.py +0 -0
  69. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sew.py +0 -0
  70. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/solar_eclipse.py +0 -0
  71. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/1.wav +0 -0
  72. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/10.wav +0 -0
  73. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/15.wav +0 -0
  74. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/2.wav +0 -0
  75. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/20_seconds.wav +0 -0
  76. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/3.wav +0 -0
  77. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/30_seconds.wav +0 -0
  78. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/4.wav +0 -0
  79. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/40_seconds.wav +0 -0
  80. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/5.wav +0 -0
  81. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/__init__.py +0 -0
  82. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c1.wav +0 -0
  83. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c1_in_60_seconds.wav +0 -0
  84. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c2.wav +0 -0
  85. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c2_in_10_minutes.wav +0 -0
  86. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c2_in_15_minutes.wav +0 -0
  87. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c2_in_20_minutes.wav +0 -0
  88. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c2_in_20_seconds.wav +0 -0
  89. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c2_in_25_minutes.wav +0 -0
  90. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c2_in_2_minutes.wav +0 -0
  91. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c2_in_30_minutes.wav +0 -0
  92. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c2_in_30_seconds.wav +0 -0
  93. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c2_in_40_minutes.wav +0 -0
  94. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c2_in_40_seconds.wav +0 -0
  95. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c2_in_4_minutes.wav +0 -0
  96. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c2_in_50_minutes.wav +0 -0
  97. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c2_in_5_minutes.wav +0 -0
  98. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c2_in_60_seconds.wav +0 -0
  99. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c2_in_6_minutes.wav +0 -0
  100. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c2_in_90_seconds.wav +0 -0
  101. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c2_plus_30_seconds.wav +0 -0
  102. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c3_in_20_seconds.wav +0 -0
  103. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c3_in_45_seconds.wav +0 -0
  104. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c3_in_8_seconds.wav +0 -0
  105. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c3_plus_10_seconds.wav +0 -0
  106. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c3_plus_15_seconds.wav +0 -0
  107. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c3_plus_1_minute.wav +0 -0
  108. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c3_plus_25_seconds.wav +0 -0
  109. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c3_plus_2_minutes.wav +0 -0
  110. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c3_plus_2_seconds.wav +0 -0
  111. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c3_plus_45_seconds.wav +0 -0
  112. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c4.wav +0 -0
  113. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/c4_in_60_seconds.wav +0 -0
  114. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/filters_on.wav +0 -0
  115. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/max.wav +0 -0
  116. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/sound/max_in_10_seconds.wav +0 -0
  117. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/usb_gps.py +0 -0
  118. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/vec.py +0 -0
  119. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench/wizard.py +0 -0
  120. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench.egg-info/dependency_links.txt +0 -0
  121. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench.egg-info/entry_points.txt +0 -0
  122. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench.egg-info/requires.txt +0 -0
  123. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/src/solareclipseworkbench.egg-info/top_level.txt +0 -0
  124. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/tests/test_live_view_preview_types.py +0 -0
  125. {solareclipseworkbench-1.10.7 → solareclipseworkbench-2.0.0rc2}/tests/test_solar_eclipse.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: solareclipseworkbench
3
- Version: 1.10.7
3
+ Version: 2.0.0rc2
4
4
  Summary: Tools to photograph solar eclipses
5
5
  Author-email: Sara Regibo <sararegibo@gmail.com>, Wim De Meester <deepskywim@gmail.com>
6
6
  License: GPL-3.0-or-later
@@ -46,8 +46,7 @@ Dynamic: license-file
46
46
  - [Installation on Windows 11](#installation-on-windows-11)
47
47
  - [Make cameras accessible in wsl](#make-cameras-accessible-in-wsl)
48
48
  - [Replace the Windows USB driver with WinUSB (required for gphoto2)](#replace-the-windows-usb-driver-with-winusb-required-for-gphoto2)
49
- - [Sony PC Remote settings (recommended)](#sony-pc-remote-settings-recommended)
50
- - [Important note for Sony bodies in `PC Only` or when the Save Destination option is not available](#important-note-for-sony-bodies-in-pc-only-or-when-the-save-destination-option-is-not-available)
49
+ - [Sony PC Remote settings discussion](#sony-pc-remote-settings-discussion)
51
50
  - [Upgrading Solar Eclipse Workbench](#upgrading-solar-eclipse-workbench)
52
51
  - [Running Solar Eclipse Workbench](#running-solar-eclipse-workbench)
53
52
  - [Command line parameters](#command-line-parameters)
@@ -359,42 +358,23 @@ usbipd attach --wsl --busid <busid>
359
358
 
360
359
  You only need to do this once; the WinUSB driver persists across reboots for that USB device.
361
360
 
362
- > **Sony Alpha cameras** additionally require **PC Remote** mode to be active on the camera itself before gphoto2 can communicate with it:
363
- > Camera Menu → Network → PC Remote Settings → PC Remote → **On**
364
- > The camera will show `(PC Control)` in its model name when correctly connected.
365
361
 
366
- ### Sony PC Remote settings (recommended)
362
+ ## Sony PC Remote settings discussion
367
363
 
368
- Sony bodies expose a *Save Destination* that controls where still images are written when `PC Remote` is enabled. Set this once on the camera menu to avoid timing and reliability problems when running rapid sequences from SEW.
364
+ To enable `PC Remote` mode on your Sony camera, please go to `MENU`, then go to `Tools` section and look for `USB Connection` setting (most probably, you will find it on the 4th screen). Press on it and choose `PC Remote` option. Note - this path applies for pre-2020 cameras; for post-2020 cameras the location of this setting might be different.
369
365
 
370
- - Menu path: `MENU → Network → PC Remote Settings → Save Destination`
371
- - Recommended value: **PC+Camera**
372
- - Writes each image to the SD card *and* keeps a copy in camera RAM so `FILE_ADDED` events still fire.
373
- - This gives SEW a guaranteed backup (SD card) while still allowing SEW to observe `FILE_ADDED` if desired.
374
- - Alternative: **Camera Only** — images go to the SD card only (safe, fast).
375
- - Avoid: **PC Only** — images are kept in camera RAM and must be downloaded over USB.
376
- - Downloading large RAW files (e.g. ARW) synchronously between shots can take several seconds and will break short-interval shot timing.
366
+ On the same screen, also search for `PC Remote Settings`. If you can't find it, it means your camera does not support saving photos to your SD card when it's being controlled from PC through USB connection. If you do find it, then you have the ability to choose between saving to `PC` or `PC+Camera` (post-2020 cameras also support `Camera` option).
377
367
 
378
- Important note for Sony bodies in `PC Only` or when the Save Destination option is not available
379
- ---------------------------------------------------------------------------------------------
368
+ For cameras which lack `PC Remote Settings`, using USB connection will come with the penalty of slow transfer of the photos, as these cameras usually have only micro USB port, which supports only USB2.0 speeds. For a 12MP camera, this might be acceptable (a 5 frame 3EV bracketing sequence centered around 1/20 takes between 8 to 12 seconds to complete, depending on the initial state of camera), but for 24MP and moreso for 42MP cameras, this might be unacceptable. We would suggest you try using Wi-Fi connection through scripts and `command` commands, as it should be much faster (but requires you are tech savvy enough to write such scripts; if you want a reference, you can take a look [here](https://github.com/fliker09/sec2025-scripts) - search for scripts which contain `http` keyword in their name). Another option would be to install an app right on your camera, which will work in a similar way to SEW - you can find it [here](https://github.com/pyzahl/SoFiMagic) (this also requires you are a bit tech savvy, but at least no scripting is involved).
380
369
 
381
- - If the camera is in **PC Only** mode (or the camera does not expose a Save Destination widget
382
- to gphoto2), every captured image is stored in the camera's RAM and must be transferred
383
- to the computer over USB. Large RAW files can take several seconds to transfer. Expect a
384
- practical capture rate of no more than one picture every 10 seconds in this mode.
385
- - Images captured in **PC Only** mode are NOT written to the camera's SD card — SEW saves
386
- downloaded files to `~/Pictures/SolarEclipseWorkbench` by default. Check that folder for
387
- your images after a test capture.
370
+ For cameras which do have `PC Remote Settings` available, the situation is much better. These cameras usually have an USB-C port, which provides USB3.0 speeds (they are much higher than USB2.0 ones!). There is also an option of saving RAW files to SD card (`PC+Camera` option), but this option should be compared against the `PC` one, as your card's write speed might be, in fact, slower than the USB3.0 transfer speed. Test both options and see which one is faster for you! On a Sony A7R IIIA, both `PC` and `PC+Camera` options take around 8 to 12 seconds for a 5 frame 3EV bracketing sequence centered around 1/20 takes between 8 to 12 seconds to complete, depending on the initial state of camera.
388
371
 
389
- If possible, set the camera to **PC+Camera** or **Camera Only** (recommended) so images are
390
- written to the SD card while SEW observes `FILE_ADDED` events; this preserves timing and
391
- guarantees a local backup on the card.
372
+ A note on multiple Sony cameras connected - if they all fire in parallel or at least close enough in timing to clash in their data transfers periods, it's preferable that no more than one of the cameras save to PC, with the other(s) having `PC+Camera` option chosen instead.
392
373
 
393
- If the camera is configured to write to the SD card (PC+Camera or Camera Only), SEW will no longer attempt blocking RAW downloads during the trigger loop. Instead SEW drains PTP events quickly so triggers remain on schedule and does not block on large USB transfers.
374
+ Warnings: if you intend to use `PC` option with a camera which has an USB-C port, please ensure that the cable is USB3.0 rated and that the port on the PC to which this cable connects is, in fact, a proper USB3.0 one.
375
+ Another thing to keep in mind - filename prefix. If you have multiple Sony cameras connected and more than one is in `PC` mode for some reason, you must ensure that each of them are using unique prefix! Please check out `Set File Name` setting in the `Tools` section (most probably on the 5th screen).
394
376
 
395
- Short guidance
396
- - If you want reliable, on-time sequences (1–2 s intervals): set **PC+Camera** or **Camera Only** on the camera. SEW will trigger on schedule and your images will be safe on the SD card.
397
- - If your camera is left in **PC Only** mode, expect slower operation and possible missed/dropped triggers while large RAW files are downloaded.
377
+ Final note on the `PC+Camera` option - SEW will not actually save JPEG files to PC, they will be ignored and the PTP events on camera flushed, with RAW files being consistently written to SD card (please don't forget to set `RAW+J PC Save Img` setting with `JPEG only` option!).
398
378
 
399
379
 
400
380
  ## Upgrading Solar Eclipse Workbench
@@ -415,7 +395,9 @@ pip show solareclipseworkbench
415
395
 
416
396
  ## Running Solar Eclipse Workbench
417
397
 
418
- - Ensure that you are connected to the Internet the first time you run and use Solar Eclipse Workbench, as it will require to download several files required for calculations.
398
+ - Please ensure that all of the connected cameras use 0.3EV exposure step (proper support for 0.5EV will arrive in a future version, for Canon and Nikon). Also, check that the camera's `Auto Power Off` setting isn't too short, as once it's asleep, camera can't be awakened by the app.
399
+
400
+ - Ensure that you are connected to the Internet the first time you run and use Solar Eclipse Workbench, as it will require to download several files required for calculations. Make sure to do this before eclipse day!
419
401
 
420
402
  - Start Solar Eclipse Workbench by executing the following commands:
421
403
 
@@ -428,36 +410,28 @@ sew
428
410
  - You can add a parameters to set the needed parameters for the eclipse. Some examples:
429
411
 
430
412
  ```bash
431
- # On macos, start the commands with sudo
432
- cd solareclipseworkbench
433
- source bin/activate
434
- sudo sew -d 2024-04-08 -lon -104.63525 -lat 24.01491 -alt 1877.3
435
- sudo sew
436
-
437
- # In Linux or using WSL on Windows, start the command without sudo
438
413
  cd solareclipseworkbench
439
414
  source bin/activate
440
415
  sew -d 2024-04-08 -lon -104.63525 -lat 24.01491 -alt 1877.3
441
416
  sew
442
417
  ```
443
418
 
444
- - There is a problem with `gphoto2`. On macOS, Solar Eclipse Workbench needs to be started with sudo rights to be able to connect to the cameras. In Linux (or Windows using wsl), sudo should not be used.
445
- - The first time you run Solar Eclipse Workbench, some files are downloaded from the internet. Make sure to do this before eclipse day!
446
-
447
419
  ### Command line parameters
448
420
 
449
421
  The following command line parameters can be used to start up gui.py.
450
422
 
451
423
 
452
- | Short parameter | Long parameter | Description |
453
- |------------------|-----------------------|----------------------------------------------------------------------------|
454
- | -h | --help | Show the help message and exit |
455
- | -d DATE | --date DATE | Date of the solar eclipse (in YYYY-MM-DD format) |
456
- | -lon LONGITUDE | --longitude LONGITUDE | Longitude of the location where to watch the solar eclipse (W is negative) |
457
- | -lat LATITUDE | --latitude LATITUDE | Latitude of the location where to watch the solar eclipse (N is positive) |
458
- | -alt ALTITUDE | --altitude ALTITUDE | Altitude of the location where to watch the solar eclipse (in meters) |
459
- | -s | --sim | Start the application in simulation mode |
460
- | --virtual-camera | --virtual-camera | Use a virtual camera. Only for simulation mode! |
424
+ | Short parameter | Long parameter | Description |
425
+ |------------------|-----------------------|-------------------------------------------------------------------------------|
426
+ | -h | --help | Show the help message and exit |
427
+ | -d DATE | --date DATE | Date of the solar eclipse (in YYYY-MM-DD format) |
428
+ | -lon LONGITUDE | --longitude LONGITUDE | Longitude of the location where to watch the solar eclipse (W is negative) |
429
+ | -lat LATITUDE | --latitude LATITUDE | Latitude of the location where to watch the solar eclipse (N is positive) |
430
+ | -alt ALTITUDE | --altitude ALTITUDE | Altitude of the location where to watch the solar eclipse (in meters) |
431
+ | -s | --sim | Start the application in simulation mode |
432
+ | -vc | --virtual-camera | Use a virtual camera. Only for simulation mode! |
433
+ | -lc | --low-cpu | Disable auto update for eclipse visualization (essential for single core CPU) |
434
+ | -scm | --sony-cont-mode | Specify continuous mode search keyword name for Sony cameras |
461
435
 
462
436
  ### UI functionality
463
437
 
@@ -727,13 +701,17 @@ Test your script before using it during a total solar eclipse! Some cameras can
727
701
  The following cameras are tested:
728
702
 
729
703
  - Canon EOS 1000D
704
+ - Canon EOS 650D
730
705
  - Canon EOS 80D
731
706
  - Canon EOS R
732
707
  - Nikon DSC D3400
708
+ - Nikon DSC D610
733
709
  - Nikon Z8
734
710
  - Nikon Z6iii
711
+ - Sony ILCE-7S (α7S)
735
712
  - Sony ILCE-7M3 (α7 III)
736
- - Sony ILCE-7R II (α7R II): Very slow, because it does not support the `PC+Camera` Save Destination mode, so every picture is downloaded over USB before the next one can be taken. Expect a practical capture rate of no more than one picture every 10 seconds with this camera.
713
+ - Sony ILCE-7RM3A (α7R IIIA)
714
+ - Sony ILCE-7R II (α7R II): Very slow, because it does not support the `PC+Camera` Save Destination mode, so every picture is downloaded over USB before the next one can be taken. Expect a practical capture rate of no more than one picture every 10 seconds with this camera.
737
715
 
738
716
  It is possible to take pictures in burst mode. The speed is limited by the speed of the camera (and card).
739
717
 
@@ -759,15 +737,17 @@ Solar Eclipse Workbench can use the following commands:
759
737
 
760
738
  This command will take a picture 1 minutes and 2 seconds before first contact (C1) with the Canon EOS 80D. The ISO will be set to 200, aperture to 8.0 and shutter speed to 1/1250s.
761
739
 
762
- - **take_burst** - Set the aperture, shutter speed and ISO of the camera and take a burst of pictures during 3 seconds (for Canon; Nikon and Sony will take 3 pictures in burst mode).
740
+ - **take_burst** - Set the aperture, shutter speed and ISO of the camera and take a burst of pictures during 3 seconds (for Sony and modern Canon cameras; Nikon and older Canon cameras will take 3 pictures in burst mode instead). Note - for Sony cameras the automatically chosen Continuous mode might be either High Speed or Low Speed (completely depends on the cameras's model). If you want to define a specific mode - check out the `--sony-cont-mode` command line option. As for Nikon cameras - your Continuous mode might be dictated by the physical dial. In such a case, please set it beforehand accordingly (it won't affect `take_picture` or `take_hdr`, so no need to touch it once set)!
763
741
 
764
742
  ```take_burst, C1, +, 0:00:08.0, Canon EOS 80D, 1/2000, 5.6, 400, 3, "Burst test"```
765
743
 
766
- - **take_bracket** - Set the aperture, shutter speed and ISO of the camera and take a bracket of 5 pictures with the given steps. This method only works in Canon cameras. Make sure to have 5 steps enabled for bracketing. Options for the steps are: +/- 1/3, +/- 2/3, +/- 1, +/- 1 1/3, +/- 1 2/3, +/- 2, +/- 2 1/3, +/- 2 2/3, +/- 3
744
+ - **take_bracket** - Set the aperture, shutter speed and ISO of the camera and take a bracket of 5 pictures with the given steps. Make sure to have 5 steps enabled for bracketing (note - if not supported, it will fallback to 3 steps instead). Options for the steps are: +/- 1/3, +/- 2/3, +/- 1, +/- 1 1/3, +/- 1 2/3, +/- 2, +/- 2 1/3, +/- 2 2/3, +/- 3.
745
+ This syntax only works for Canon. Sony doesn't support it, so instead you have to provide the desired mode name in this field instead (e.g. `"Bracketing C 3.0 Steps 5 Pictures"`). You can look up for the available modes using this command: `gphoto2  --get-config=/main/capturesettings/capturemode`.
746
+ As for Nikon - it also doesn't support this syntax, so please use instead this convention: `"0.7 5"`. First float number is exposure step in EV and the other number is the amount of frames to take in the bracketing sequence. An important note for Nikon cameras with physical dial for capture mode - app will assume you already chose Continuous mode (please see `take_burst` above for more information).
767
747
 
768
748
  ```take_bracket, C1, +, 0:00:08.0, Canon EOS 80D, 1/2000, 5.6, 400, "+/- 1 2/3", "Bracket test"```
769
749
 
770
- - **take_hdr** - Take an HDR sequence by ramping the shutter speed from a starting (fastest) speed down by the given number of full stops and back up again, while keeping aperture and ISO fixed. Uses `gp_camera_trigger_capture` for maximum speed so successive shots are fired without waiting for each file to be written to the card. The shutter speed choices available on the connected camera are queried at runtime, so the sequence always stays within the actual speeds the body supports. Works on Canon EOS, Nikon, and Sony Alpha cameras. Total shots fired: 2 × stops + 1 (the slowest exposure appears once at the midpoint).
750
+ - **take_hdr** - Take an HDR sequence by ramping the shutter speed from a starting (fastest) speed down by the given number of full stops and back up again, while keeping aperture and ISO fixed. Uses `gp_camera_trigger_capture` for maximum speed so successive shots are fired without waiting for each file to be written to the card. The shutter speed choices available on the connected camera are queried at runtime, so the sequence always stays within the actual speeds the body supports. Total shots fired: 2 × stops + 1 (the slowest exposure appears once at the midpoint). An important warning for Sony cameras - if the camera is in `PC` mode, the total number of taken shots must not exceed the size of camera's buffer! Otherwise, the entire sequence will be lost. You can find the buffer size of some of the Sony cameras [here](https://capturetheuniverse.com/#buffer-size-usb-speed).
771
751
 
772
752
  The sequence for `stops=4` starting at `1/2000` would be: `1/2000 → 1/1000 → 1/500 → 1/250 → 1/125 → 1/250 → 1/500 → 1/1000 → 1/2000` (9 shots).
773
753
 
@@ -835,7 +815,9 @@ endfor
835
815
  ## Shortcomings
836
816
 
837
817
  - In normal mode, only one picture per two seconds can be made.
838
- - The computer you are using will probably fall asleep during the solar eclipse. You can prevent this on macOS and Linux using [caffeine](https://www.caffeine-app.net/). On Windows, you can use the Windows [powertoys](https://awake.den.dev/).
818
+ - The computer you are using will probably fall asleep during the solar eclipse. You can prevent this on macOS and Linux using [caffeine](https://www.caffeine-app.net/). On Windows, you can use the Windows [powertoys](https://awake.den.dev/).
819
+ - Sony cameras after cold boot might return wrong configuration values. Please press `Camera(s)` button to retrieve them one more time.
820
+ - Nikon cameras after fresh connection might take a long time to finish their first shot. A potential mitigation is ensuring that the SD card has no other shots on it already.
839
821
 
840
822
  ## Converting scripts from Solar Eclipse Maestro
841
823
 
@@ -843,11 +825,18 @@ Scripts from Solar Eclipse Maestro are converted automatically to scripts that c
843
825
 
844
826
  ## Error handling
845
827
 
846
- If something goes wrong, an error message will be logged in the log file `/tmp/solareclipseworkbench.log`.
828
+ If something goes wrong, an error message will be shown in the terminal and logged in the log file `/tmp/solareclipseworkbench.log`.
829
+
830
+ ## Handling camera(s) disconnect(s)
831
+
832
+ In case your camera was turned off or disconnected from USB, you don't have to restart the app to reconnect back to your camera. Once your camera is back online, press `Stop`, agree to remove the scheduled jobs, press `Camera(s)` and see if the camera is properly detected. After that, load your script again (thankfully, the file dialog will remember your last directory) and the execution will resume (do note that the events missed while you were restoring the connection will not be re-attempted).
833
+
834
+ Note - this should work fine even if multiple cameras are connected and only one of them is affected. In case it doesn't work for some reason, turn off / disconnect from USB all of the cameras and try again.
847
835
 
848
836
  ## Development Guide
849
837
 
850
838
  When you want to help with the development of Solar Eclipse Workbench, some extra installation is needed.
839
+
851
840
  ### Installation on macOS
852
841
 
853
842
  - For modern Apple Mac computers (using Apple Silicon processors), install [homebrew](https://brew.sh/). Add your homebrew/bin directory to your PATH. Then install gphoto2 and GDAL (required by geopandas) using homebrew:
@@ -998,3 +987,5 @@ See [CHANGELOG.md](CHANGELOG.md) for a detailed list of changes and updates to t
998
987
  - <a href="https://www.flaticon.com/free-icons/simulation" title="simulation icons">Simulation icons created by Freepik - Flaticon</a>
999
988
  - <a href="https://www.flaticon.com/free-icons/save" title="save icons">Save icons created by Freepik - Flaticon</a>
1000
989
  - <a href="https://www.flaticon.com/free-icons/refresh" title="refresh icons">Refresh icons created by Magnific - Flaticon</a>
990
+ - <a href="https://www.flaticon.com/free-icons/live-video" title="live video icons">Live video icons created by bearicons - Flaticon</a>
991
+
@@ -15,8 +15,7 @@
15
15
  - [Installation on Windows 11](#installation-on-windows-11)
16
16
  - [Make cameras accessible in wsl](#make-cameras-accessible-in-wsl)
17
17
  - [Replace the Windows USB driver with WinUSB (required for gphoto2)](#replace-the-windows-usb-driver-with-winusb-required-for-gphoto2)
18
- - [Sony PC Remote settings (recommended)](#sony-pc-remote-settings-recommended)
19
- - [Important note for Sony bodies in `PC Only` or when the Save Destination option is not available](#important-note-for-sony-bodies-in-pc-only-or-when-the-save-destination-option-is-not-available)
18
+ - [Sony PC Remote settings discussion](#sony-pc-remote-settings-discussion)
20
19
  - [Upgrading Solar Eclipse Workbench](#upgrading-solar-eclipse-workbench)
21
20
  - [Running Solar Eclipse Workbench](#running-solar-eclipse-workbench)
22
21
  - [Command line parameters](#command-line-parameters)
@@ -328,42 +327,23 @@ usbipd attach --wsl --busid <busid>
328
327
 
329
328
  You only need to do this once; the WinUSB driver persists across reboots for that USB device.
330
329
 
331
- > **Sony Alpha cameras** additionally require **PC Remote** mode to be active on the camera itself before gphoto2 can communicate with it:
332
- > Camera Menu → Network → PC Remote Settings → PC Remote → **On**
333
- > The camera will show `(PC Control)` in its model name when correctly connected.
334
330
 
335
- ### Sony PC Remote settings (recommended)
331
+ ## Sony PC Remote settings discussion
336
332
 
337
- Sony bodies expose a *Save Destination* that controls where still images are written when `PC Remote` is enabled. Set this once on the camera menu to avoid timing and reliability problems when running rapid sequences from SEW.
333
+ To enable `PC Remote` mode on your Sony camera, please go to `MENU`, then go to `Tools` section and look for `USB Connection` setting (most probably, you will find it on the 4th screen). Press on it and choose `PC Remote` option. Note - this path applies for pre-2020 cameras; for post-2020 cameras the location of this setting might be different.
338
334
 
339
- - Menu path: `MENU → Network → PC Remote Settings → Save Destination`
340
- - Recommended value: **PC+Camera**
341
- - Writes each image to the SD card *and* keeps a copy in camera RAM so `FILE_ADDED` events still fire.
342
- - This gives SEW a guaranteed backup (SD card) while still allowing SEW to observe `FILE_ADDED` if desired.
343
- - Alternative: **Camera Only** — images go to the SD card only (safe, fast).
344
- - Avoid: **PC Only** — images are kept in camera RAM and must be downloaded over USB.
345
- - Downloading large RAW files (e.g. ARW) synchronously between shots can take several seconds and will break short-interval shot timing.
335
+ On the same screen, also search for `PC Remote Settings`. If you can't find it, it means your camera does not support saving photos to your SD card when it's being controlled from PC through USB connection. If you do find it, then you have the ability to choose between saving to `PC` or `PC+Camera` (post-2020 cameras also support `Camera` option).
346
336
 
347
- Important note for Sony bodies in `PC Only` or when the Save Destination option is not available
348
- ---------------------------------------------------------------------------------------------
337
+ For cameras which lack `PC Remote Settings`, using USB connection will come with the penalty of slow transfer of the photos, as these cameras usually have only micro USB port, which supports only USB2.0 speeds. For a 12MP camera, this might be acceptable (a 5 frame 3EV bracketing sequence centered around 1/20 takes between 8 to 12 seconds to complete, depending on the initial state of camera), but for 24MP and moreso for 42MP cameras, this might be unacceptable. We would suggest you try using Wi-Fi connection through scripts and `command` commands, as it should be much faster (but requires you are tech savvy enough to write such scripts; if you want a reference, you can take a look [here](https://github.com/fliker09/sec2025-scripts) - search for scripts which contain `http` keyword in their name). Another option would be to install an app right on your camera, which will work in a similar way to SEW - you can find it [here](https://github.com/pyzahl/SoFiMagic) (this also requires you are a bit tech savvy, but at least no scripting is involved).
349
338
 
350
- - If the camera is in **PC Only** mode (or the camera does not expose a Save Destination widget
351
- to gphoto2), every captured image is stored in the camera's RAM and must be transferred
352
- to the computer over USB. Large RAW files can take several seconds to transfer. Expect a
353
- practical capture rate of no more than one picture every 10 seconds in this mode.
354
- - Images captured in **PC Only** mode are NOT written to the camera's SD card — SEW saves
355
- downloaded files to `~/Pictures/SolarEclipseWorkbench` by default. Check that folder for
356
- your images after a test capture.
339
+ For cameras which do have `PC Remote Settings` available, the situation is much better. These cameras usually have an USB-C port, which provides USB3.0 speeds (they are much higher than USB2.0 ones!). There is also an option of saving RAW files to SD card (`PC+Camera` option), but this option should be compared against the `PC` one, as your card's write speed might be, in fact, slower than the USB3.0 transfer speed. Test both options and see which one is faster for you! On a Sony A7R IIIA, both `PC` and `PC+Camera` options take around 8 to 12 seconds for a 5 frame 3EV bracketing sequence centered around 1/20 takes between 8 to 12 seconds to complete, depending on the initial state of camera.
357
340
 
358
- If possible, set the camera to **PC+Camera** or **Camera Only** (recommended) so images are
359
- written to the SD card while SEW observes `FILE_ADDED` events; this preserves timing and
360
- guarantees a local backup on the card.
341
+ A note on multiple Sony cameras connected - if they all fire in parallel or at least close enough in timing to clash in their data transfers periods, it's preferable that no more than one of the cameras save to PC, with the other(s) having `PC+Camera` option chosen instead.
361
342
 
362
- If the camera is configured to write to the SD card (PC+Camera or Camera Only), SEW will no longer attempt blocking RAW downloads during the trigger loop. Instead SEW drains PTP events quickly so triggers remain on schedule and does not block on large USB transfers.
343
+ Warnings: if you intend to use `PC` option with a camera which has an USB-C port, please ensure that the cable is USB3.0 rated and that the port on the PC to which this cable connects is, in fact, a proper USB3.0 one.
344
+ Another thing to keep in mind - filename prefix. If you have multiple Sony cameras connected and more than one is in `PC` mode for some reason, you must ensure that each of them are using unique prefix! Please check out `Set File Name` setting in the `Tools` section (most probably on the 5th screen).
363
345
 
364
- Short guidance
365
- - If you want reliable, on-time sequences (1–2 s intervals): set **PC+Camera** or **Camera Only** on the camera. SEW will trigger on schedule and your images will be safe on the SD card.
366
- - If your camera is left in **PC Only** mode, expect slower operation and possible missed/dropped triggers while large RAW files are downloaded.
346
+ Final note on the `PC+Camera` option - SEW will not actually save JPEG files to PC, they will be ignored and the PTP events on camera flushed, with RAW files being consistently written to SD card (please don't forget to set `RAW+J PC Save Img` setting with `JPEG only` option!).
367
347
 
368
348
 
369
349
  ## Upgrading Solar Eclipse Workbench
@@ -384,7 +364,9 @@ pip show solareclipseworkbench
384
364
 
385
365
  ## Running Solar Eclipse Workbench
386
366
 
387
- - Ensure that you are connected to the Internet the first time you run and use Solar Eclipse Workbench, as it will require to download several files required for calculations.
367
+ - Please ensure that all of the connected cameras use 0.3EV exposure step (proper support for 0.5EV will arrive in a future version, for Canon and Nikon). Also, check that the camera's `Auto Power Off` setting isn't too short, as once it's asleep, camera can't be awakened by the app.
368
+
369
+ - Ensure that you are connected to the Internet the first time you run and use Solar Eclipse Workbench, as it will require to download several files required for calculations. Make sure to do this before eclipse day!
388
370
 
389
371
  - Start Solar Eclipse Workbench by executing the following commands:
390
372
 
@@ -397,36 +379,28 @@ sew
397
379
  - You can add a parameters to set the needed parameters for the eclipse. Some examples:
398
380
 
399
381
  ```bash
400
- # On macos, start the commands with sudo
401
- cd solareclipseworkbench
402
- source bin/activate
403
- sudo sew -d 2024-04-08 -lon -104.63525 -lat 24.01491 -alt 1877.3
404
- sudo sew
405
-
406
- # In Linux or using WSL on Windows, start the command without sudo
407
382
  cd solareclipseworkbench
408
383
  source bin/activate
409
384
  sew -d 2024-04-08 -lon -104.63525 -lat 24.01491 -alt 1877.3
410
385
  sew
411
386
  ```
412
387
 
413
- - There is a problem with `gphoto2`. On macOS, Solar Eclipse Workbench needs to be started with sudo rights to be able to connect to the cameras. In Linux (or Windows using wsl), sudo should not be used.
414
- - The first time you run Solar Eclipse Workbench, some files are downloaded from the internet. Make sure to do this before eclipse day!
415
-
416
388
  ### Command line parameters
417
389
 
418
390
  The following command line parameters can be used to start up gui.py.
419
391
 
420
392
 
421
- | Short parameter | Long parameter | Description |
422
- |------------------|-----------------------|----------------------------------------------------------------------------|
423
- | -h | --help | Show the help message and exit |
424
- | -d DATE | --date DATE | Date of the solar eclipse (in YYYY-MM-DD format) |
425
- | -lon LONGITUDE | --longitude LONGITUDE | Longitude of the location where to watch the solar eclipse (W is negative) |
426
- | -lat LATITUDE | --latitude LATITUDE | Latitude of the location where to watch the solar eclipse (N is positive) |
427
- | -alt ALTITUDE | --altitude ALTITUDE | Altitude of the location where to watch the solar eclipse (in meters) |
428
- | -s | --sim | Start the application in simulation mode |
429
- | --virtual-camera | --virtual-camera | Use a virtual camera. Only for simulation mode! |
393
+ | Short parameter | Long parameter | Description |
394
+ |------------------|-----------------------|-------------------------------------------------------------------------------|
395
+ | -h | --help | Show the help message and exit |
396
+ | -d DATE | --date DATE | Date of the solar eclipse (in YYYY-MM-DD format) |
397
+ | -lon LONGITUDE | --longitude LONGITUDE | Longitude of the location where to watch the solar eclipse (W is negative) |
398
+ | -lat LATITUDE | --latitude LATITUDE | Latitude of the location where to watch the solar eclipse (N is positive) |
399
+ | -alt ALTITUDE | --altitude ALTITUDE | Altitude of the location where to watch the solar eclipse (in meters) |
400
+ | -s | --sim | Start the application in simulation mode |
401
+ | -vc | --virtual-camera | Use a virtual camera. Only for simulation mode! |
402
+ | -lc | --low-cpu | Disable auto update for eclipse visualization (essential for single core CPU) |
403
+ | -scm | --sony-cont-mode | Specify continuous mode search keyword name for Sony cameras |
430
404
 
431
405
  ### UI functionality
432
406
 
@@ -696,13 +670,17 @@ Test your script before using it during a total solar eclipse! Some cameras can
696
670
  The following cameras are tested:
697
671
 
698
672
  - Canon EOS 1000D
673
+ - Canon EOS 650D
699
674
  - Canon EOS 80D
700
675
  - Canon EOS R
701
676
  - Nikon DSC D3400
677
+ - Nikon DSC D610
702
678
  - Nikon Z8
703
679
  - Nikon Z6iii
680
+ - Sony ILCE-7S (α7S)
704
681
  - Sony ILCE-7M3 (α7 III)
705
- - Sony ILCE-7R II (α7R II): Very slow, because it does not support the `PC+Camera` Save Destination mode, so every picture is downloaded over USB before the next one can be taken. Expect a practical capture rate of no more than one picture every 10 seconds with this camera.
682
+ - Sony ILCE-7RM3A (α7R IIIA)
683
+ - Sony ILCE-7R II (α7R II): Very slow, because it does not support the `PC+Camera` Save Destination mode, so every picture is downloaded over USB before the next one can be taken. Expect a practical capture rate of no more than one picture every 10 seconds with this camera.
706
684
 
707
685
  It is possible to take pictures in burst mode. The speed is limited by the speed of the camera (and card).
708
686
 
@@ -728,15 +706,17 @@ Solar Eclipse Workbench can use the following commands:
728
706
 
729
707
  This command will take a picture 1 minutes and 2 seconds before first contact (C1) with the Canon EOS 80D. The ISO will be set to 200, aperture to 8.0 and shutter speed to 1/1250s.
730
708
 
731
- - **take_burst** - Set the aperture, shutter speed and ISO of the camera and take a burst of pictures during 3 seconds (for Canon; Nikon and Sony will take 3 pictures in burst mode).
709
+ - **take_burst** - Set the aperture, shutter speed and ISO of the camera and take a burst of pictures during 3 seconds (for Sony and modern Canon cameras; Nikon and older Canon cameras will take 3 pictures in burst mode instead). Note - for Sony cameras the automatically chosen Continuous mode might be either High Speed or Low Speed (completely depends on the cameras's model). If you want to define a specific mode - check out the `--sony-cont-mode` command line option. As for Nikon cameras - your Continuous mode might be dictated by the physical dial. In such a case, please set it beforehand accordingly (it won't affect `take_picture` or `take_hdr`, so no need to touch it once set)!
732
710
 
733
711
  ```take_burst, C1, +, 0:00:08.0, Canon EOS 80D, 1/2000, 5.6, 400, 3, "Burst test"```
734
712
 
735
- - **take_bracket** - Set the aperture, shutter speed and ISO of the camera and take a bracket of 5 pictures with the given steps. This method only works in Canon cameras. Make sure to have 5 steps enabled for bracketing. Options for the steps are: +/- 1/3, +/- 2/3, +/- 1, +/- 1 1/3, +/- 1 2/3, +/- 2, +/- 2 1/3, +/- 2 2/3, +/- 3
713
+ - **take_bracket** - Set the aperture, shutter speed and ISO of the camera and take a bracket of 5 pictures with the given steps. Make sure to have 5 steps enabled for bracketing (note - if not supported, it will fallback to 3 steps instead). Options for the steps are: +/- 1/3, +/- 2/3, +/- 1, +/- 1 1/3, +/- 1 2/3, +/- 2, +/- 2 1/3, +/- 2 2/3, +/- 3.
714
+ This syntax only works for Canon. Sony doesn't support it, so instead you have to provide the desired mode name in this field instead (e.g. `"Bracketing C 3.0 Steps 5 Pictures"`). You can look up for the available modes using this command: `gphoto2  --get-config=/main/capturesettings/capturemode`.
715
+ As for Nikon - it also doesn't support this syntax, so please use instead this convention: `"0.7 5"`. First float number is exposure step in EV and the other number is the amount of frames to take in the bracketing sequence. An important note for Nikon cameras with physical dial for capture mode - app will assume you already chose Continuous mode (please see `take_burst` above for more information).
736
716
 
737
717
  ```take_bracket, C1, +, 0:00:08.0, Canon EOS 80D, 1/2000, 5.6, 400, "+/- 1 2/3", "Bracket test"```
738
718
 
739
- - **take_hdr** - Take an HDR sequence by ramping the shutter speed from a starting (fastest) speed down by the given number of full stops and back up again, while keeping aperture and ISO fixed. Uses `gp_camera_trigger_capture` for maximum speed so successive shots are fired without waiting for each file to be written to the card. The shutter speed choices available on the connected camera are queried at runtime, so the sequence always stays within the actual speeds the body supports. Works on Canon EOS, Nikon, and Sony Alpha cameras. Total shots fired: 2 × stops + 1 (the slowest exposure appears once at the midpoint).
719
+ - **take_hdr** - Take an HDR sequence by ramping the shutter speed from a starting (fastest) speed down by the given number of full stops and back up again, while keeping aperture and ISO fixed. Uses `gp_camera_trigger_capture` for maximum speed so successive shots are fired without waiting for each file to be written to the card. The shutter speed choices available on the connected camera are queried at runtime, so the sequence always stays within the actual speeds the body supports. Total shots fired: 2 × stops + 1 (the slowest exposure appears once at the midpoint). An important warning for Sony cameras - if the camera is in `PC` mode, the total number of taken shots must not exceed the size of camera's buffer! Otherwise, the entire sequence will be lost. You can find the buffer size of some of the Sony cameras [here](https://capturetheuniverse.com/#buffer-size-usb-speed).
740
720
 
741
721
  The sequence for `stops=4` starting at `1/2000` would be: `1/2000 → 1/1000 → 1/500 → 1/250 → 1/125 → 1/250 → 1/500 → 1/1000 → 1/2000` (9 shots).
742
722
 
@@ -804,7 +784,9 @@ endfor
804
784
  ## Shortcomings
805
785
 
806
786
  - In normal mode, only one picture per two seconds can be made.
807
- - The computer you are using will probably fall asleep during the solar eclipse. You can prevent this on macOS and Linux using [caffeine](https://www.caffeine-app.net/). On Windows, you can use the Windows [powertoys](https://awake.den.dev/).
787
+ - The computer you are using will probably fall asleep during the solar eclipse. You can prevent this on macOS and Linux using [caffeine](https://www.caffeine-app.net/). On Windows, you can use the Windows [powertoys](https://awake.den.dev/).
788
+ - Sony cameras after cold boot might return wrong configuration values. Please press `Camera(s)` button to retrieve them one more time.
789
+ - Nikon cameras after fresh connection might take a long time to finish their first shot. A potential mitigation is ensuring that the SD card has no other shots on it already.
808
790
 
809
791
  ## Converting scripts from Solar Eclipse Maestro
810
792
 
@@ -812,11 +794,18 @@ Scripts from Solar Eclipse Maestro are converted automatically to scripts that c
812
794
 
813
795
  ## Error handling
814
796
 
815
- If something goes wrong, an error message will be logged in the log file `/tmp/solareclipseworkbench.log`.
797
+ If something goes wrong, an error message will be shown in the terminal and logged in the log file `/tmp/solareclipseworkbench.log`.
798
+
799
+ ## Handling camera(s) disconnect(s)
800
+
801
+ In case your camera was turned off or disconnected from USB, you don't have to restart the app to reconnect back to your camera. Once your camera is back online, press `Stop`, agree to remove the scheduled jobs, press `Camera(s)` and see if the camera is properly detected. After that, load your script again (thankfully, the file dialog will remember your last directory) and the execution will resume (do note that the events missed while you were restoring the connection will not be re-attempted).
802
+
803
+ Note - this should work fine even if multiple cameras are connected and only one of them is affected. In case it doesn't work for some reason, turn off / disconnect from USB all of the cameras and try again.
816
804
 
817
805
  ## Development Guide
818
806
 
819
807
  When you want to help with the development of Solar Eclipse Workbench, some extra installation is needed.
808
+
820
809
  ### Installation on macOS
821
810
 
822
811
  - For modern Apple Mac computers (using Apple Silicon processors), install [homebrew](https://brew.sh/). Add your homebrew/bin directory to your PATH. Then install gphoto2 and GDAL (required by geopandas) using homebrew:
@@ -967,3 +956,5 @@ See [CHANGELOG.md](CHANGELOG.md) for a detailed list of changes and updates to t
967
956
  - <a href="https://www.flaticon.com/free-icons/simulation" title="simulation icons">Simulation icons created by Freepik - Flaticon</a>
968
957
  - <a href="https://www.flaticon.com/free-icons/save" title="save icons">Save icons created by Freepik - Flaticon</a>
969
958
  - <a href="https://www.flaticon.com/free-icons/refresh" title="refresh icons">Refresh icons created by Magnific - Flaticon</a>
959
+ - <a href="https://www.flaticon.com/free-icons/live-video" title="live video icons">Live video icons created by bearicons - Flaticon</a>
960
+
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "solareclipseworkbench"
3
- version = "1.10.7"
3
+ version = "2.0.0rc2"
4
4
 
5
5
  description = "Tools to photograph solar eclipses"
6
6
  readme = "README.md"