Skip to content

Orthanc CLI v0.1.0

Pre-release
Pre-release

Choose a tag to compare

View all tags
@proencaj proencaj released this 02 Dec 17:44
· 21 commits to main since this release
v0.1.0
8429598

Orthanc CLI v0.1.0

A command-line interface for managing Orthanc DICOM servers.

🎉 Initial Public Release

This is the first public release of Orthanc CLI! This tool was created to streamline daily workflows with Orthanc DICOM servers, making it fast and efficient to manage medical imaging data from the command line.

What's New

Core Features

Resource Management

  • Complete CRUD operations for patients, studies, series, and instances
  • List, get, create, update, and delete DICOM resources
  • Bulk operations support for batch processing

DICOM Networking

  • Full modality configuration management (create, update, remove)
  • C-ECHO: Test connectivity to remote DICOM nodes
  • C-FIND: Query remote modalities for studies
  • C-MOVE: Move studies between modalities
  • C-GET: Retrieve studies from remote modalities
  • C-STORE: Store studies to remote modalities

Data Operations

  • Anonymize patients, studies, series, and instances
  • Download DICOM files and archives (ZIP)
  • Upload DICOM files to Orthanc servers
  • Archive creation for studies and series

System Administration

  • Advanced resource search using /tools/find endpoint
  • Dynamic log level adjustment
  • Server management (shutdown, reset)
  • Version information display

Configuration

  • Simple YAML-based configuration (~/.orthanc-cli.yaml)
  • Environment variable support for all settings
  • Secure credential management
  • Custom config file support via --config flag

Developer Features

  • Cross-platform builds (Linux and macOS, amd64 and arm64)
  • HTTPS support with optional TLS verification
  • JSON output support for scripting
  • Interactive confirmations for destructive operations
  • Comprehensive error handling

Installation

Download Pre-built Binaries

Download the appropriate archive for your platform below:

Linux:

macOS:

Quick Install

Linux/macOS (Intel):

curl -L https://github.com/proencaj/orthanc-cli/releases/download/v0.1.0/orthanc-v0.1.0-$(uname -s | tr '[:upper:]' '[:lower:]')-amd64.tar.gz | tar xz
sudo mv orthanc /usr/local/bin/

macOS (Apple Silicon):

curl -L https://github.com/proencaj/orthanc-cli/releases/download/v0.1.0/orthanc-v0.1.0-darwin-arm64.tar.gz | tar xz
sudo mv orthanc /usr/local/bin/

Build from Source

Requires Go 1.25 or later:

go install github.com/proencaj/orthanc-cli/cmd/orthanc@v0.1.0

Or clone and build:

git clone https://github.com/proencaj/orthanc-cli.git
cd orthanc-cli
git checkout v0.1.0
make install

Quick Start

Initialize configuration:

orthanc config init
orthanc config set orthanc.url http://your-orthanc-server:8042
orthanc config set orthanc.username your-username
orthanc config set orthanc.password your-password

Test connectivity:

orthanc studies list
orthanc version

Documentation

Checksums

SHA256 checksums for release verification:

c65187358dccea857ae388a92fae2e8a0c234d98f71287dbe2aaf1cbf712376b  orthanc-v0.1.0-darwin-amd64.tar.gz
e4e27db4b9fb2977af9c0a64528481fce32942bd890d4f738f304e8b5748fbe6  orthanc-v0.1.0-darwin-arm64.tar.gz
8b72cd67385a35ca5213170d6e2e411ea0e184d916504d964697a55096a870ce  orthanc-v0.1.0-linux-amd64.tar.gz
a084655a918dca21dbf49cbb1c05085cfc86b791fb83b98242de2451d1210fb3  orthanc-v0.1.0-linux-arm64.tar.gz

What's Next

The roadmap for future features is being defined. If you have feature requests or ideas, please open an issue on GitHub!

Support

Contributing

Contributions are welcome! Please see our Contributing Guidelines.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Assets 7
Loading