Memacs - Emacs和Org mode用户的数字生活元数据管理工具

2007年2月14日你在做什么?在你遇到女朋友的那天,你正在做哪些任务?你最后一次牙医预约是什么时候?上个月你和客户开会时,谁给你打电话了?

大多数人无法回答这些问题。但是有了Memacs你就可以!

Memacs从你电脑上许多不同的现有数据源(文件名、电子邮件、推文、书签等)中提取元数据(主题、时间戳、联系信息等),并生成可由GNU Emacs和Org mode读取的文件。

Memacs作为系统的核心组件,是所有从各个数据源添加数据的连接器的中心。这些连接器被称为Memacs模块或简称为/模块/。

你的日程表会自动填充类似白皮书中截图所示的条目:

[图片:展示了一些使用短信、文件名日期戳、Twitter、RSS、IMAP、电话和git模块的演示数据]

目标用户群:Emacs和Org mode的用户
所需技能:创建/修改shell脚本代码;创建计划任务
项目托管在 https://github.com/novoid/Memacs

** 目录

[[#installation][安装]]
[[#getting-started][入门]]
[[#workflows][工作流程]]
[[#memacs-modules][Memacs模块]]
[[#changelog][更新日志]]
[[#example-story][示例故事]]
[[#background][背景]]
[[#contribute][贡献]]
[[#license][许可证]]

** 安装

*** 使用Pip安装

安装Memacs最简单的方法是使用pip:

: pip install memacs[all]

这将在你的系统上安装全套模块及其所有依赖项。

如果你想更精细地定义依赖项,可以使用一个或多个extras:=gps=、=rss=、=ical=、=lastfm=、=battery=或=twitter=,如下例所示:

: pip install memacs[gps,rss]

*** 从Git手动设置

如果你更喜欢"传统方式"设置环境,可以手动进行:

从github克隆或下载存储库
确保使用Python 3版本
创建虚拟环境或
导出/设置~~PYTHONPATH~~

: PYTHONPATH=/path/to/memacs

安装依赖项

: pip install -r requirements.txt

** 入门

使用Memacs模块的基本概念如下:

选择要使用的Memacs模块并进行设置:
- 阅读~~docs~~文件夹中的模块描述文件。
- 每个[[#memacs-modules][模块]]共享全局选项,但也有其自己的一组自定义参数。
- 在命令行中从Memacs的~~bin~~文件夹手动启动你选择的模块,并带上~--help~~参数,例如~~bin/memacs_csv.py --help~,以获取该模块参数的概览。
- 你可能想要为模块调用开发和测试脚本(=.bat=或=.sh=),在命令行中执行,然后...
当这个脚本按预期工作时,设置定期调用,以便你的数据通过Memacs定期转换为Org mode。
- 这通常通过操作系统相关的方法完成:
对于从正在运行的Emacs实例进行更新,独立于周期性计划(例如,从远足回来后运行Memacs的照片模块),你可以向Emacs添加一个键绑定,例如=C-c m p=

#+begin_src emacs-lisp (defun mp-update-memacs-photos () "Memacs照片模块的额外运行(即非cron计划的运行)。" (interactive) (shell-command (format "~/org/update-memacs-photos.sh") ) )

(global-set-key (kbd "C-c m p") 'mp-update-memacs-photos) #+end_src

被调用的脚本需要提供可执行权限。Mickey Petersen在[[https://www.masteringemacs.org/article/mastering-key-bindings-emacs][掌握Emacs中的键绑定]]中编写了这种技术的更多背景信息。
考虑你可能想尝试的另一个Memacs模块;-)

请确保你也阅读了[[docs/FAQs_and_Best_Practices.org][常见问题和最佳实践]],因为它包含了许多关于如何满足你的需求以及如何选择合理设置的技巧和窍门。

** 工作流程

这里有一些工作流程,只是为了给你一个初步印象,说明Memacs如何为你带来很多数字化乐趣。

*** 基础知识

当设置了一个或多个Memacs模块并开始将数据流入你的Memacs Org mode文件时,你有很多选择来使用Memacs进行个人工作流程。

使用Memacs最基本的变化是,你可能想在日程表中看到Memacs处理的数据:

你要么生成(1)在你的[[https://orgmode.org/manual/Agenda-files.html][日程文件]]中的Org mode文件,要么生成(2)[[https://orgmode.org/manual/Archiving.html#Archiving][存档文件]],其中或多或少空的Org mode文件存根在你的日程文件中(如[[https://github.com/novoid/Memacs/blob/master/docs/FAQs_and_Best_Practices.org#performance-and-scalability][常见问题]]中所述)。

这样,生成的时间戳信息就会进入你的正常日程(1)或扩展的存档模式(2)(在日程中按=v A=也会显示存档文件的内容)。

*** 文件名时间戳及相关功能

我个人一直使用的一个Memacs功能提供了一个稍微复杂一点的工作流程,其基本数据由[[docs/memacs_filenametimestamps.org][文件名时间戳模块]]提供。该模块索引我所有文件名中包含ISO日期戳或ISO时间戳的文件,就像[[http://linux-sxs.org/utilities/updatedb.html][updatedb]]为"locate"所做的那样。当设置好此模块并生成文件索引（每晚进行）后，乐趣就开始了。通过模块文档中提到的elisp代码片段，我只需指定文件名就能链接到任何文件。这些链接永远不会失效，因为文件位于哪个文件夹已经不重要了。

请参阅我的Emacs配置，并查找所有出现"tsfile"（时间戳文件）的地方，这是我为这些文件设置的自定义链接。

我甚至扩展了这个工作流，使我的博客系统能够独立于位置链接到"tsfile:"图片。这真是太棒了。

** Memacs模块

arbtt
battery
csv
filenametimestamps
firefox_history
chrome_history
git
gpx
ical
imap
lastfm
mu
phonecalls
photos
rss
simplephonelogs
sms
svn
twitter
whatsapp
KODI日志

这个模块是开发者的示例：csv

以下模块尚未采用新的统一框架：

maildir
mbox（也适用于新闻组）
- 另请参阅works-for-me-hack/memacs-mbox.org
银行账户：
- easybank.at：参见tmp/bank_statements/easybank.at/memacs-easybank.org
新闻组
- slrn：参见tmp/emails/mbox/works-for-me-hack/memacs-mbox.org

以下模块目前只是粗略的想法，可能有朝一日会被实现（也许是由你？）：

tagstore：参见tmp/tagstore/memacs-tagstore.org
日历：
- JPilot-datebook：参见tmp/calendars/memacs-jpilot-datebook.org
任务：
- JPilot-todos：参见tmp/tasklists/jpilot-todos/memacs-jpilot-todos.org
博客系统：
- Serendipity：参见tmp/blog_systems/serendipity/memacs-serendipity.org

** 更新日志

版本2020.06.05.1
- 新功能
  - 新模块：memacs_kodi
  - Andrea Ghensi提供了改进的pip安装方法
- 错误修复
  - 修复chrome.py输出，包含org标题的url和标题
  - 对Chrome模块进行了多项改进
  - filenametimestamps：修复了check_datestamp_correctness（#97）
版本2019.11.06.1
- 新功能
  - orgformat现在是一个外部库
- 错误修复
  - 修复当区域设置不是en_US时的问题
2019-10-09.1之前的版本未使用此更新日志记录。请阅读git提交消息。

示例故事

想象一下，你已经在使用Memacs。

当你回想起那天参加了一个关于"Getting Things Done"（GTD）的有趣讲座时，你启动了GNU Emacs，打开了你的主要Org mode文件。你进入Agenda视图，选择了几个月前的那个特定日子。

在那里，你看到从下午2点到3点，你安排了这个讲座。然后你发现，在这个时间段内，出现了一些包含ISO 8601时间戳的JPEG文件，这些文件被一个模块索引了。（filenametimestamp模块）

这些图片包含了你认为有趣的幻灯片，你用你的智能手机拍摄了下来。谁能记得在讲座中拍了照片呢？

讲座结束十分钟后，你在Twitter上发了一条简短的消息，为你的粉丝分享了一些有用的URL。这次这些URL对你自己也很有用！（Twitter模块）

那天晚上，你看到一条来自讲座作者的incoming电子邮件的条目。现在你想起来，在讲座结束时你们进行了一次很棒的谈话，他承诺给你一些关于他电脑上那个不错的GTD工具的额外信息。很高兴你也得到了那封邮件的链接。如果没有Memacs，你可能永远不会再想起那封邮件。（Maildir模块）

然后，你那天保存了一些书签，几乎都与你从GTD讲座中得到的好主意有关。（delicious模块）

这个小故事只展示了几个使用案例，不同的模块如何结合给定的数据源及其信息，提供与事件相关的整体视图。由于Org mode有链接功能，实际数据不需要重复（除了Memacs提取的元数据）。电子邮件、文件、书签等都是通过链接而不是复制的方式关联的。

[1] 使用句点而不是冒号 - 这只是因为Microsoft文件系统的古老限制；比如"2011-02-14T14.35.42 ideas.jpg"

背景

1945年，Vannevar Bush写了一篇著名的文章《As We May Think》，他在文中提出了一个叫做"Memex"的"记忆扩展器"的想法。memex可以存储与一个人相关的所有信件、书籍和其他信息。

除了预见了超文本等几项技术，他还定义了一个设备，该设备可以保存所有元数据和数据，并提供关联路径来访问信息。在上个世纪的最后十年，微软研究院有一个研究项目，产生了MyLifeBits。这个软件试图存储用户的每一条信息，如办公文档、屏幕截图、桌面电脑上活动窗口的名称，甚至自动拍摄照片（SenseCam）。这项工作并未产生任何（开源）软件产品。贝尔和杰梅尔写了一本名为《Total Recall》的书。

Memacs项目试图用开源和开放标准来实现范内瓦·布什的愿景。因此，它的名字"Memacs"显然是"GNU Emacs"和"Memex"的结合。

Memacs使用GNU Emacs Org模式来可视化和访问由Memacs模块提取的信息：使用标签、时间戳、全文搜索等，GNU Emacs能够得出不同的视图。最重要的视图可能是议程视图，你可以根据选定的时间框架看到特定日/周/月发生的任何事情。但你也可以得出其他视图。例如，你可以选择使用标签的布尔组合生成一个简明的搜索结果。

与Memacs相关，项目创始人开发了一个名为tagstore的研究软件。这个系统允许用户使用标签存储（本地）文件，而不需要文件夹层次结构。作为自然延伸，tagstore针对（本地）文件的关联访问。你可能也想了解一下tagstore。Memacs和tagstore是非常有用的组合。

如果你想知道如何以简单且与操作系统无关的方式高效组织数字文件，请阅读Karl的这篇博文。它可能会给你的工作流程带来一些想法。

Karl还写了一篇关于Memacs的白皮书，从科学角度描述了Memacs。

类似项目：