meta1v

command module

v1.1.1 Latest Latest Go to latest Published: Feb 12, 2026 License: AGPL-3.0 Imports: 1 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/ma-tf/meta1v

Links

Open Source Insights

README ¶

meta1v

Codecov

meta1v is a command-line tool for viewing and manipulating metadata for Canon EOS-1V files of the EFD format.

Installation

From releases

Download the latest release for your platform from the releases page.

Extract the archive and optionally add the binary to your PATH:

tar -xzf meta1v_*.tar.gz
sudo mv meta1v /usr/local/bin/

From source

Requires Go 1.25.7 or later:

go install github.com/ma-tf/meta1v@latest

Install man pages

Man pages are included in the release archives. To install them:

# After extracting the release archive
sudo cp man/*.1 /usr/local/share/man/man1/
sudo mandb  # Update man database (Linux)
man meta1v

Quick Start

View roll information from an EFD file:

meta1v roll list data.efd

Export frame data to CSV:

meta1v frame export data.efd output.csv

Write EXIF metadata to an image:

meta1v exif data.efd 1 image.jpg

Documentation

CLI Reference - Complete command reference
Man pages - Use man meta1v for offline reference (after installation)

Available Commands

roll - List or export roll information from EFD files
frame - List or export frame information from EFD files
exif - Write EXIF metadata from EFD file to target image file
customfunctions - List or export custom function settings from EFD files
focusingpoints - Display autofocus point grids from EFD files
thumbnail - Display embedded thumbnail images from EFD files

Run meta1v --help for detailed usage information, or see the complete CLI reference.

Configuration

meta1v can be configured via:

Config file: $HOME/.meta1v/config.yaml or ./config.yaml
Environment variables: Prefix with META1V_ (e.g., META1V_LOG_LEVEL=debug)
Command-line flags: --strict, --config, etc.

Example configuration file (~/.meta1v/config.yaml):

log:
  level: info
strict: false
timeout: 3m

Configuration Options

Option	Type	Default	Description
`log.level`	string	`warn`	Log level: `debug`, `info`, `warn`, `error`
`strict`	boolean	`false`	Enable strict mode (fail on unknown metadata values)
`timeout`	duration	`3m`	Command execution timeout

Global Flags

--config - Specify custom config file path
-s, --strict - Enable strict mode
-h, --help - Display help for any command

Licence

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.

Development Prerequisites

To contribute to this project, you'll need:

Go 1.25.7 or later
go-licenses for dependency license tracking: go install github.com/google/go-licenses/v2@latest

The pre-commit hook automatically generates a NOTICE file with dependency licenses.

Documentation ¶

Overview ¶

Package main is the entry point for the meta1v CLI tool.

meta1v is a command-line utility for interacting with Canon EFD files, allowing users to view, export, and manipulate metadata recorded by Canon EOS film cameras.

Source Files ¶

View all Source files

main.go

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
cmd Package cmd provides the command-line interface for meta1v.	Package cmd provides the command-line interface for meta1v.
internal
cli Package cli provides the root command and CLI interface for the meta1v application.	Package cli provides the root command and CLI interface for the meta1v application.
cli/customfunctions Package customfunctions provides business logic for listing and exporting custom function settings.	Package customfunctions provides business logic for listing and exporting custom function settings.
cli/customfunctions/export Package export provides the CLI command for exporting custom function settings to CSV format.	Package export provides the CLI command for exporting custom function settings to CSV format.
cli/customfunctions/export/mocks Package export_test is a generated GoMock package.	Package export_test is a generated GoMock package.
cli/customfunctions/ls Package ls provides the CLI command for listing custom function settings from EFD files.	Package ls provides the CLI command for listing custom function settings from EFD files.
cli/customfunctions/ls/list/mocks Package list_test is a generated GoMock package.	Package list_test is a generated GoMock package.
cli/customfunctions/ls/mocks Package ls_test is a generated GoMock package.	Package ls_test is a generated GoMock package.
cli/exif Package exif provides the CLI command for writing EXIF metadata to image files.	Package exif provides the CLI command for writing EXIF metadata to image files.
cli/exif/mocks Package exif_test is a generated GoMock package.	Package exif_test is a generated GoMock package.
cli/focusingpoints Package focusingpoints provides business logic for displaying focusing point grids from EFD files.	Package focusingpoints provides business logic for displaying focusing point grids from EFD files.
cli/focusingpoints/ls Package ls provides the CLI command for displaying focusing point grids from EFD files.	Package ls provides the CLI command for displaying focusing point grids from EFD files.
cli/focusingpoints/ls/mocks Package ls_test is a generated GoMock package.	Package ls_test is a generated GoMock package.
cli/frame Package frame provides business logic for listing and exporting frame information from EFD files.	Package frame provides business logic for listing and exporting frame information from EFD files.
cli/frame/export Package export provides the CLI command for exporting frame information to CSV format.	Package export provides the CLI command for exporting frame information to CSV format.
cli/frame/export/mocks Package export_test is a generated GoMock package.	Package export_test is a generated GoMock package.
cli/frame/ls Package ls provides the CLI command for listing frame information from EFD files.	Package ls provides the CLI command for listing frame information from EFD files.
cli/frame/ls/mocks Package ls_test is a generated GoMock package.	Package ls_test is a generated GoMock package.
cli/roll Package roll provides business logic for listing and exporting film roll information.	Package roll provides business logic for listing and exporting film roll information.
cli/roll/export Package export provides the CLI command for exporting film roll information to CSV format.	Package export provides the CLI command for exporting film roll information to CSV format.
cli/roll/export/mocks Package export_test is a generated GoMock package.	Package export_test is a generated GoMock package.
cli/roll/ls Package ls provides the CLI command for listing film roll information from EFD files.	Package ls provides the CLI command for listing film roll information from EFD files.
cli/roll/ls/mocks Package ls_test is a generated GoMock package.	Package ls_test is a generated GoMock package.
cli/thumbnail Package thumbnail provides business logic for displaying embedded thumbnails from EFD files.	Package thumbnail provides business logic for displaying embedded thumbnails from EFD files.
cli/thumbnail/ls Package ls provides the CLI command for displaying embedded thumbnails from EFD files.	Package ls provides the CLI command for displaying embedded thumbnails from EFD files.
cli/thumbnail/ls/mocks Package ls_test is a generated GoMock package.	Package ls_test is a generated GoMock package.
container Package container provides dependency injection for meta1v services.	Package container provides dependency injection for meta1v services.
domain Package domain provides validated business domain types for Canon EFD metadata.	Package domain provides validated business domain types for Canon EFD metadata.
records Package records defines the binary structure of Canon EFD files.	Package records defines the binary structure of Canon EFD files.
records/mocks Package records_test is a generated GoMock package.	Package records_test is a generated GoMock package.
service/csvexport Package csvexport provides CSV export functionality for Canon EFD metadata.	Package csvexport provides CSV export functionality for Canon EFD metadata.
service/csvexport/mocks Package csvexport_test is a generated GoMock package.	Package csvexport_test is a generated GoMock package.
service/display Package display provides formatting and rendering services for Canon EFD metadata.	Package display provides formatting and rendering services for Canon EFD metadata.
service/display/mocks Package display_test is a generated GoMock package.	Package display_test is a generated GoMock package.
service/efd Package efd provides services for reading and parsing Canon EFD binary files.	Package efd provides services for reading and parsing Canon EFD binary files.
service/efd/mocks Package efd_test is a generated GoMock package.	Package efd_test is a generated GoMock package.
service/exif Package exif provides services for writing EXIF metadata to image files using Canon EFD frame data.	Package exif provides services for writing EXIF metadata to image files using Canon EFD frame data.
service/exif/mocks Package exif_test is a generated GoMock package.	Package exif_test is a generated GoMock package.
service/osexec Package osexec provides an abstraction layer over os/exec for command execution.	Package osexec provides an abstraction layer over os/exec for command execution.
service/osexec/mocks Package osexec_test is a generated GoMock package.	Package osexec_test is a generated GoMock package.
service/osfs Package osfs provides an abstraction layer over the os package's filesystem operations.	Package osfs provides an abstraction layer over the os package's filesystem operations.
service/osfs/mocks Package osfs_test is a generated GoMock package.	Package osfs_test is a generated GoMock package.
tools/docgen command