layout	default
title	LinM 한글 설치 가이드
description	LinM(Linux용 텍스트 UI 파일 관리자, Mdir 클론)을 sudo 없이 사용자 홈 경로($HOME/.local)에 안전하게 설치하는 방법을 안내합니다.
lang	ko
permalink	/

LinM 한글 설치 가이드

LinM은 Linux용 텍스트 UI 파일 관리자(Mdir 클론)입니다. 이 문서는 사용자 홈 경로($HOME/.local)에 안전하게 설치하는 방법을 안내합니다.

• 오리지널 프로젝트: https://github.com/la9527/linm
• fork (최신 패치 포함): https://github.com/zirize/linm
• 이 저장소: LinM 설치 가이드 문서 전용

---

1) 사전 준비 (의존성 설치)

빌드에 필요한 도구와 라이브러리를 먼저 설치합니다. (관리자 권한 필요)

Debian / Ubuntu

sudo apt-get update
sudo apt-get install -y build-essential cmake git gettext \
    libncursesw5-dev libssl-dev libssh2-1-dev \
    libsource-highlight-dev

Arch Linux

sudo pacman -S --needed base-devel cmake git gettext \
    ncurses openssl libssh2 source-highlight

Fedora / RHEL / CentOS

# Fedora
sudo dnf install -y gcc-c++ cmake git make gettext \
    ncurses-devel openssl-devel libssh2-devel \
    source-highlight-devel

# CentOS/RHEL (EPEL 저장소 활성화 필요)
sudo yum install -y gcc-c++ cmake3 git make gettext \
    ncurses-devel openssl-devel libssh2-devel \
    source-highlight-devel

---

2) 소스 클론 및 사용자 경로 설치

아래 방식은 sudo 없이 사용자 경로에 설치하므로 시스템 전역 환경에 영향을 주지 않습니다.

최신 패치(v0.9.3)가 포함된 fork를 클론하려면 아래 URL을 사용하세요:

git clone https://github.com/zirize/linm.git

오리지널 저장소를 사용하려면:

git clone https://github.com/la9527/linm.git

cd linm

mkdir -p build
cd build

cmake -DCMAKE_INSTALL_PREFIX=$HOME/.local ..
make
make install

설치 후 $HOME/.local/bin이 PATH에 없다면 ~/.bashrc에 추가합니다:

export PATH="$HOME/.local/bin:$PATH"
source ~/.bashrc

---

3) linm.sh 경로 보정

작업 디렉토리 유지 기능을 사용하려면 바이너리(linm)가 아닌 스크립트(linm.sh)를 통해 실행해야 합니다.

1. 파일 열기:

   nano $HOME/.local/bin/linm.sh

2. 실행 라인을 확인해 실제 경로로 변경:
   • 설치 상태에 따라 @bindir@/linm $@ 또는 OFF/linm $@ 형태일 수 있습니다.
   • 두 경우 모두 플레이스홀더이므로, 실제 바이너리 경로로 바꿔야 합니다.

   /home/<사용자명>/.local/bin/linm $@

예: 사용자명이 zirize이면 아래와 같습니다.

/home/zirize/.local/bin/linm $@

---

4) Bash alias 등록 (.bash_aliases 권장)

Bash에서는 ~/.bashrc 직접 수정 대신 ~/.bash_aliases에 alias를 두는 방식을 권장합니다.

1. 파일 열기(없으면 생성):

   nano ~/.bash_aliases

2. 아래 alias 추가:

   alias linm='. $HOME/.local/bin/linm.sh'

   ⚠️ 점(.)과 공백이 반드시 있어야 현재 셸 세션에 디렉토리 변경이 반영됩니다.

3. 적용:

   source ~/.bash_aliases
   source ~/.bashrc

~/.bash_aliases가 자동 로드되지 않으면 ~/.bashrc에 아래가 있는지 확인하세요.

if [ -f ~/.bash_aliases ]; then
    . ~/.bash_aliases
fi

---

5) 동작 확인

linm

실행 후 다른 디렉토리로 이동해서 종료했을 때, 터미널 현재 경로가 마지막 작업 위치로 유지되면 정상입니다.

---

6) 버전 업그레이드

새 버전 빌드·설치 후 처음 실행하면 자동으로 설정을 업그레이드합니다:

• 기존 설정을 ~/.config/linm/back/에 백업
• 새로운 설정 키만 병합 (기존 커스터마이징 유지)
• 설정 반영을 위해 자동 재시작

별도로 설정을 초기화하거나 파일을 복사할 필요가 없습니다.

---

주요 단축키 (v0.9.3 기준)

키	기능
Alt+F	파일명 필터 (실시간, 디렉토리 제외, 이동 시 유지)
Alt+S	정렬 방식 팝업 선택 (None/Name/Ext/Size/Time/Color)
Alt+X / Ctrl+Q / Ctrl+D	종료
F8 / Alt+D	삭제
F1	도움말
Ctrl+B	설정 변경
Ctrl+O	서브쉘
Ctrl+F	파일 찾기

전체 단축키는 F1 도움말 또는 ~/.config/linm/keyset.cfg를 참고하세요.

---

마우스 비활성화 옵션

# 실행 시 옵션
linm --nomouse
linm -M

# 환경변수
LINM_NO_MOUSE=1 linm

# ~/.config/linm/default.cfg 설정
Mouse = Off