shakshi3104 / litex

Live Text Command Line Tool

LiTeX

LiTeX allows use Live Text as the command line tool and output results to a text file.

LiTeX requires macOS 13 to use Live Text (using ImageAnalyzer of VisionKit). On macOS 12, LiTeX uses VNRecognizeTextRequest of Vision.

Usage

OVERVIEW: Command line tool of Live Text

LiTeX allows use Live Text as the command line tool and output results to a text file.

USAGE: litex [<image-filepath>] [--use-vision] [--lang <lang>] [--support-lang]

ARGUMENTS:
  <image-filepath>        An image filepath.

OPTIONS:
  --use-vision            Use VNRecognizeTextRequest of Vision. This option is only
                          available on macOS 13 and newer.
  --lang <lang>           Set recognition language. If you want to check supported
                          languages, run `litex --support-lang`. This option is for
                          VNRecognizeTextRequest. (default: ja-JP)
  --support-lang          Show supported languages.
  --version               Show the version.
  -h, --help              Show help information.

Installation

1. Download the latest version binary file
2. Open terminal app and move to the directory contating the "litex" file
3. Add the executable permission to the file: chmod +x litex
4. Move the file to the /usr/local/bin directory: mv litex /usr/local/bin

Requirements

• macOS 12.0+
• Xcode 14.1+

Swift Package Dependencies

• Swift Argument Parser 1.1.0+

litex's Issues

Installation question

This isn't an issue with the program. It's an issue with my own ignorance.

How do I accomplish step one of the installation? It says to download the binary file. Which one is that? I looked through all the folders and I don't see a file named litex, yet step two says to chmod +x litex then move it to /usr/local/bin.

latest release

Mac OS denies execution, because "it's not possible to check the software on malware". I try to compile it with Xcode. Ventura 13.4 (22F66), M1-max

Installation question

I see in the installation instructions that one is to obtain the code. Then navigate in Terminal to the directory which contains the code.

However, I am next asked to add execute permissions to a file called litex. However none of the files is just called litex. I do see a couple of .swift files in a directory.

litex
└── LiTeX-main
├── LICENSE
├── LiTeX
│   ├── LiveTextCLI.swift
│   └── NSImage+Extension.swift
├── README.md
├── litex.xcodeproj
│   ├── project.pbxproj
│   ├── project.xcworkspace
│   │   ├── contents.xcworkspacedata
│   │   ├── xcshareddata
│   │   │   ├── IDEWorkspaceChecks.plist
│   │   │   └── swiftpm
│   │   │   ├── Package.resolved
│   │   │   └── configuration
│   │   └── xcuserdata
│   │   └── keeline.xcuserdatad
│   │   └── UserInterfaceState.xcuserstate
│   ├── xcshareddata
│   │   └── xcschemes
│   │   ├── LiveTextPlayground.xcscheme
│   │   └── Release.xcscheme
│   └── xcuserdata
│   └── user.xcuserdatad
│   └── xcschemes
│   └── xcschememanagement.plist
└── materials
├── litex_demo.gif
└── litex_icon.png

Would it be more effective to do a git pull? The zip method doesn't work as I expect it would. I have not had similar problems with other github projects that I have installed.

James

Question: Any way to autodetect the language?

It's amazing. Thank you so much for open-sourcing it. I've played around with it a lot and learned from it. Thanks for this.

Unfortunately, there doesn't seem to be a discussion tab, so I'm writing here instead.

Is there any way to automatically detect the language and/or scan for mixed language content? I'm attempting to capture my students' handwritten homework, which often includes descriptions in languages other than German on the same sheet of paper.

Thank you so much,
Johannes