Ignoring errors - Shell commands documentation

By default, the *Shell commands* plugin displays all error messages produced by shell commands in a notification balloon in the top right corner of the Obsidian window. Sometimes, however, error messages might be unimportant. SC provides you with two ways on how to ignore error messages on a per shell command basis. ## Ignore all error messages produced by a shell command 1. Read a guide about [[Output channels#How to select output channels for a shell command|how to select output channels for a shell command]]. 2. Set the output channel of `stderr` to [[Output channel - Ignore|Ignore]]. **Note** that while this method is easy and simple to use, it might not be the best solution. If you encounter a regular error message that you want to suppress, this will do it, but it will also hide more infrequent error messages, that would be important to be seen. Consider using the below method instead, if possible. ## Ignore error messages based on a shell command's exit code An exit code (aka error code) is used to identify error situations programmatically. It offers a simple way to ignore certain predefined failures, while letting unexpected failures still produce visible error messages. The exit code `0` usually means that there were no errors, but in practice you might still encounter some error messages raising up with exit code `0`. 1. Go to the plugin's settings panel. 2. Look for the shell command whose error messages you want to ignore, and click the *Stdout/stderr handling, Ignore errors* icon next to it: ![[Settings-main-click-output-channels-icon.png]] 3. An *extra options* modal opens up. In the modal, look for *Ignore error codes*. Type the exit code that you want to ignore. If you need to ignore multiple exit codes, you can separate them with commas `,`. ![[Settings-modal-output.png]] You can check which exit code you need to use by executing a shell command that fails and looking at the number in the brackets: ![[Output-error-balloon.png]] # History - [0.8.0 - 2021-12-10](https://github.com/Taitava/obsidian-shellcommands/blob/main/CHANGELOG.md#080---2021-12-10): Changed error code ignoring so that also error code 0 can be ignored. ([#107](https://github.com/Taitava/obsidian-shellcommands/issues/107)). - [0.5.0 - 2021-10-02](https://github.com/Taitava/obsidian-shellcommands/blob/main/CHANGELOG.md#050---2021-10-02): Added support for ignoring all error output regardless of error codes. ([#34](https://github.com/Taitava/obsidian-shellcommands/issues/34)). - [0.4.0 - 2021-09-26](https://github.com/Taitava/obsidian-shellcommands/blob/main/CHANGELOG.md#040---2021-09-26): Added support for ignoring error codes that are greater than or equal to 1. ([#36](https://github.com/Taitava/obsidian-shellcommands/issues/36)). > [!page-edit-history]- Page edit history: 2021-10-31 ➔ 2022-12-11 > - [2022-12-11](https://github.com/Taitava/obsidian-shellcommands-documentation/commit/10ffc392aaf12df9cc211fb05030d43bcb772aad): Change ## History to # History on all pages. > - [2022-01-02](https://github.com/Taitava/obsidian-shellcommands-documentation/commit/13c1f6a730fafb892c14d6598b58592b3bdb5fc0): Typo fixes. > - [2021-12-10](https://github.com/Taitava/obsidian-shellcommands-documentation/commit/23c17d85a416aad113fe19e5773d2c04208501bc): Update 0.8.0 changelog links. > - [2021-12-04](https://github.com/Taitava/obsidian-shellcommands-documentation/commit/784b2c4f11238d3deeb4661ff80817e7dfa042b9): Ignoring errors: Added history. > - [2021-11-25](https://github.com/Taitava/obsidian-shellcommands-documentation/commit/e98d750bc24d867629c6de1fa5019c31b6e87f49): Exract output channels to separate files. > - [2021-11-21](https://github.com/Taitava/obsidian-shellcommands-documentation/commit/f368a217fcc5484e3f078b598d6a2c3e2cbe35cb): Fix typos using WebStorm. > - [2021-11-21](https://github.com/Taitava/obsidian-shellcommands-documentation/commit/ed5b9fbea3bbdbb6cb0b6571c8fae9f3ba6e795a): Ignoring errors.md. > - [2021-11-20](https://github.com/Taitava/obsidian-shellcommands-documentation/commit/49f6a5aa991b118b0193538cb111300aca91dc96): Improve some links. > - [2021-11-20](https://github.com/Taitava/obsidian-shellcommands-documentation/commit/366f1cecd4709d2da639b76fd2269e0f6d4a11ba): Fix a couple of links. > - [2021-10-31](https://github.com/Taitava/obsidian-shellcommands-documentation/commit/2dd3261379bc2817e7ea01b96872402ad7c3c4d1): Some quick plans for the documentation. > > [See this list of commits on GitHub](https://github.com/Taitava/obsidian-shellcommands-documentation/commits/main/Output%20handling/Ignoring%20errors.md). > ^page-edit-history