diff --git a/alt-tab-macos.xcodeproj/project.pbxproj b/alt-tab-macos.xcodeproj/project.pbxproj index cf2f159e..25f7ad12 100644 --- a/alt-tab-macos.xcodeproj/project.pbxproj +++ b/alt-tab-macos.xcodeproj/project.pbxproj @@ -509,7 +509,6 @@ BF0C89B4DEC3CBB8ECD29E1B /* import_l10n_strings_from_poeditor.sh */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.script.sh; path = import_l10n_strings_from_poeditor.sh; sourceTree = ""; }; BF0C89D7F23D82A3FF442E0B /* build_app.sh */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.script.sh; path = build_app.sh; sourceTree = ""; }; BF0C89F6EA16DD7322626E20 /* FUNDING.yml */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.yaml; path = FUNDING.yml; sourceTree = ""; }; - BF0C89F77BFA42510A8FFDAB /* FAQ.md */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = net.daringfireball.markdown; path = FAQ.md; sourceTree = ""; }; BF0C8A261AAA42191426A587 /* run_tests.sh */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.script.sh; path = run_tests.sh; sourceTree = ""; }; BF0C8A3DAEA5B956593AF97A /* kn */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.plist.strings; name = kn; path = InfoPlist.strings; sourceTree = ""; }; BF0C8A479D2B7FB80531F037 /* PopupButtonLikeSystemSettings.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = PopupButtonLikeSystemSettings.swift; sourceTree = ""; }; @@ -2019,7 +2018,6 @@ D04BADB5AA570748C717D31A /* Changelog-bare.md */, BF0C815B4782DEEEDB2C76C5 /* Support.md */, BF0C8880DFDFAC86CE1E2E31 /* Gemfile.lock */, - BF0C89F77BFA42510A8FFDAB /* FAQ.md */, ); path = docs; sourceTree = ""; diff --git a/docs/FAQ.md b/docs/FAQ.md deleted file mode 100644 index e08cfb0f..00000000 --- a/docs/FAQ.md +++ /dev/null @@ -1,36 +0,0 @@ -## Can it show, or hide, this window? - -It's sometimes hard to say that some dialog, HUD, UI element, is a window or not. Not everyone will agree that a particular window is a window. AltTab does its best to decide what a window is, and show it to the user. - -Some apps are not native macOS apps, or poorly programmed. Such apps will use "windows" to code things like menus, and play tricks like hidding a window instead of closing it. Notorious examples: Electron apps (e.g. Slack, Discord, etc) and apps using cross-platform SDKs (e.g. Adobe apps, Steam, IntelliJ, etc). - -If a window is showing, and you think it shouldn't, please contact the app maker so they can fix their product. - -## Can it show individual browser tabs? - -Browser windows are not standard windows or tabs. They are custom UI painted by each browser, in their own unique way. There is no macOS API to screenshot a browser tab. Some browser may not even render a tab that's not active, so there are no pixels to screenshot. - -Browser may offer custom integration to know about tabs, screenshot, active them. However, each browser is unique, and it would require to write these integrations for each one, as well as to maintain them. Browsers evolve fast, so maintaining multiple fast-changing integrations is not attainable. - -## Can we add window-management features? - -AltTab is not intended to be a window manager. It will not add features such as: resizing windows, organizing them into tiles, Dock enhancements. - -[Other apps](http://localhost:4000/#alternatives) offer such experiences. - -AltTab aims at being the best at the Windows-style alt+tab experience. - -## Can it be on the App Store? - -AltTab uses **many** private APIs. This prevents us from publishing on the App Store. It's a shame. Many more casual users would benefit from it. However, without these private APIs, the user experience would be crippled. We use private APIs for refined details, but also for basic functionality. - -## Where are settings stored? - -The app uses the standard macOS API to store settings. You can interact with them from the Terminal, using the `defaults` command: -* List current settings: `defaults read com.lwouis.alt-tab-macos.plist` -* Update a setting: `defaults write com.lwouis.alt-tab-macos.plist AppleAccentColor -int 4` -* Export settings to a file: `defaults export com.lwouis.alt-tab-macos.plist /tmp/my-export.plist` - -## Can I share an idea or report a bug? - -Please open an issue on [GitHub](https://github.com/lwouis/alt-tab-macos/issues) diff --git a/docs/Introduction.md b/docs/Introduction.md index 91fa8038..80eaf803 100644 --- a/docs/Introduction.md +++ b/docs/Introduction.md @@ -31,6 +31,23 @@ Alternative Styles * Drag-and-drop things on top of window thumbnails * Accessibility: VoiceOver, sticky keys, reduced transparency, etc +## FAQ + +Find [Frequently Asked Questions on GitHub](https://github.com/lwouis/alt-tab-macos/discussions/categories/frequently-asked-questions?discussions_q=category%3A%22Frequently+Asked+Questions%22+). + +## Configuration + +Change the shortcut keys, switch to a Windows theme and more, using the Settings window: + +
+ Screenshot: General preferences + Screenshot: Controls preferences + Screenshot: Appearance preferences + Screenshot: Appearance preferences (details) + Screenshot: Blacklist preferences + Screenshot: Policies preferences +
+ ## Compatibility * __macOS version:__ from 10.12 to latest @@ -50,19 +67,6 @@ AltTab doesn’t communicate to any server for so-called telemetry. AltTab will AltTab has been designed to take as few resources as possible on the user computer. The app itself is kept as small as possible. CPU usage is kept to a minimum, especially while in the background. The goal is to respect the user and try to have no negative impact on their experience. -## Configuration - -Change the shortcut keys, switch to a Windows theme and more, using the Settings window: - -
- Screenshot: General preferences - Screenshot: Controls preferences - Screenshot: Appearance preferences - Screenshot: Appearance preferences (details) - Screenshot: Blacklist preferences - Screenshot: Policies preferences -
- ## CLI usage You can run CLI commands directly on the executable inside the .app bundle (e.g. `/Applications/AltTab.app/Contents/MacOS/AltTab`) diff --git a/docs/_layouts/default.html b/docs/_layouts/default.html index 9296cf3f..9e935515 100644 --- a/docs/_layouts/default.html +++ b/docs/_layouts/default.html @@ -72,10 +72,6 @@ Introduction -