https://github.com/sixarm/gpg-decrypt

Use GPG to decrypt a file using our best settings
https://github.com/sixarm/gpg-decrypt

encryption gpg script shell unix

Last synced: 9 months ago
JSON representation

Use GPG to decrypt a file using our best settings

• Host: GitHub
• URL: https://github.com/sixarm/gpg-decrypt
• Owner: SixArm
• Created: 2016-04-07T02:53:05.000Z (almost 10 years ago)
• Default Branch: main
• Last Pushed: 2025-04-14T08:44:15.000Z (9 months ago)
• Last Synced: 2025-04-22T13:14:49.029Z (9 months ago)
• Topics: encryption, gpg, script, shell, unix
• Language: Shell
• Size: 61.5 KB
• Stars: 7
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Code of conduct: CODE_OF_CONDUCT.md
  • Codeowners: CODEOWNERS

Awesome Lists containing this project

README

          
# gpg-decrypt:
decrypt a file using our best settings



Syntax:

    gpg-decrypt 

    

Example:

    $ gpg-decrypt example.txt.gpg > example.txt

Output is a new decrypted file:

    example.txt

## Settings

To get our settings, we use these gpg options:

  * `--quiet`: Try to be as quiet as possible.

  * `--no-greeting`: Suppress the initial copyright message but do not enter batch mode.

If you are on an older system, then you may want to add this:

  * `--no-use-agent`: Do not use a system agent such as Ubuntu's gnome-keyring process.

  * `--pinentry-mode=loopback`: Use the terminal for PIN encry.

## More examples

To decrypt a file:

    $ gpg-decrypt foo.gpg

To decrypt a file to a specific output file name:

    $ gpg-decrypt foo.gpg --output goo

To decrypt a directory:

    $ gpg-dncrypt foo.tar.gpg | tar -x

To decrypt a file then delete it:

    $ gpg-decrypt foo.gpg && rm foo.gpg

To decrypt a directory then delete it:

    $ gpg-dncrypt foo.tar.gpg | tar -x && rm foo.tar.gpg

## Advice

We tend to use these naming conventions:

  * GPG file name extension `.gpg`.

  * tar file extension `.tar`.

We tend to skip compression:

  * We tend to use `gpg` without using compression.

  * We tend to use `tar` without using compression.

## Command

The command is:

    gpg \

    --decrypt \

    --quiet \

    --no-greeting \

    --pinentry-mode=loopback \

    "$@"

## Troubleshooting

### TTY

If you get error messages like this:

    gpg: Inappropriate ioctl for device

    gpg: problem with the agent: Inappropriate ioctl for device

    gpg: error creating passphrase: Operation cancelled

    gpg: symmetric encryption of `[stdin]' failed: Operation cancelled

Then try this:

    $ export GPG_TTY=$(tty)

### Restart

If you get error message like this:

    gpg: WARNING: server 'gpg-agent' is older than us (2.2.6 < 2.2.7)

    gpg: Note: Outdated servers may lack important security fixes.

    gpg: Note: Use the command "gpgconf --kill all" to restart them.

    gpg: signal Interrupt caught ... exiting

Then try this:

    $ gpgconf --kill all

## See also

 

These commands are similar:

  * [`gpg-encrypt`](https://github.com/SixArm/gpg-encrypt): 

    use GPG to encrypt a file using our best settings.

  

  * [`gpg-decrypt`](https://github.com/SixArm/gpg-decrypt): 

    use GPG to decrypt a file using our best settings.

  * [`openssl-encrypt`](https://github.com/SixArm/openssl-encrypt): 

    use OpenSLL to encrypt a file using our best settings.

  

  * [`openssl-decrypt`](https://github.com/SixArm/openssl-decrypt): 

    use OpenSSL to decrypt a file using our best settings.

 

 

## Tracking

  * Command: gpg-decrypt

  * Website: https://sixarm.com/gpg-decrypt

  * Cloning: https://github.com/sixarm/gpg-decrypt

  * Version: 4.0.0

  * Created: 2010-05-20

  * Updated: 2018-11-01

  * License: GPL

  * Contact: Joel Parker Henderson (joel@joelparkerhenderson.com)

  * Tracker: 15aff3e7c5a9635607f085773eee0238