[Share]用其他程序打开PDF（Open PDF with specific application）

[l0o0]

使用指定程序打开PDF，在首次打开时会检测配置变量，如果配置名称extensions.actionsTags.mypdfapp 不存在则跳出窗口，可以窗口中粘贴指定程序的exe路径（windows下火狐的路径是这样，C:\\Program Files\\Mozilla Firefox\\firefox.exe，注意空格和分隔符）

如果首次设置好PDF阅读器路径，那后期如果要改，建议直接到高级 -> 拉到最下方编辑器 -> 搜索配置名称extensions.actionsTags.mypdfapp 进行手动修改

You can open PDF with a specific PDF application when you right click on a PDF attachment.

Event: None
Operation: Script
Shortcut: None
Name: Open PDF

const window = require("window");
let path = await item.getFilePathAsync();
let exePath = Zotero.Prefs.get("extensions.actionsTags.mypdfapp", true);
if (!exePath) {
  exePath = window.prompt("输入打开PDF的exe程序路径");
  Zotero.Prefs.set("extensions.actionsTags.mypdfapp", exePath, true);
}
// Example: exe path string in windows, C:\\Program Files\\Mozilla Firefox\\firefox.exe
Zotero.launchFileWithApplication(path, exePath);
return "打开成功";

[Donnie-L]

如何重新获取程序路径？

[l0o0]

你这个路径不对，可参考我代码里的这个路径C:\\Program Files\\Mozilla Firefox\\firefox.exe，注意这里的路径分隔符是\\，双斜线

[MengjiaHe]

mac中路径应该怎么表示呢 含空格？/Applications/PDF%20Expert.app 这样也不行～

[l0o0]

@MengjiaHe 参考一下这个

cd "a b" 
cd 'a b' 
cd a\ b

[MengjiaHe]

@MengjiaHe 参考一下这个

cd "a b" 
cd 'a b' 
cd a\ b

thanks！
直接填写路径就可以：

[mjthoraval]

Thank you very much!
Is there a way to make this work also from a right click on the parent item, to open the default child item if it is a PDF file (that would open with a double click or enter on the item), or the first PDF file if the default child item is not a PDF file?

So something similar to this: https://github.com/retorquere/zotero-open-pdf

[mjthoraval]

Based on the other replies, I have modified the code so that:

• It also opens from the parent item
• The path to the PDF Reader application is directly included in the script

But it still only works for a single item. How can I modify the code so that it works on multiple selected items?

if(item) return;

const window = require("window");
const ZoteroPane = require("ZoteroPane");

async function getPDFAttachmentPath(item) {
    // If it is PDF, get the path directly
    if (item.isAttachment() && item.attachmentContentType === 'application/pdf') {
        return await item.getFilePathAsync();
    }
    // If it is a parent item, find its PDF attachment
    else if (item.isRegularItem() && !item.isAttachment()) {
        let attachments = await item.getAttachments();
        for (let attachmentID of attachments) {
            let attachment = await Zotero.Items.getAsync(attachmentID);
            if (attachment.attachmentContentType === 'application/pdf') {
                return await attachment.getFilePathAsync();
            }
			//break;
        }
    }
    return null;
}

async function openPDF(item) {
    let filePath = await getPDFAttachmentPath(item);
    if (!filePath) {
        Zotero.alert(window, "Open failed", "PDF attachment not found");
        return "PDF attachment not found";
    }
    let exePath = "C:\\Program Files\\Adobe\\Acrobat DC\\Acrobat\\Acrobat.exe";
    // Example: exe path string in windows, C:\\Program Files\\Mozilla Firefox\\firefox.exe
    Zotero.launchFileWithApplication(filePath, exePath);
}

// Open the currently selected item
return await openPDF(items[0]);
// Reduce prompt interference
// return "Opened successfully";

[windingwind]

if(!items?.length) return;

const window = require("window");

async function getPDFAttachmentPath(item) {
    // If it is PDF, get the path directly
    if (item.isAttachment() && item.attachmentContentType === 'application/pdf') {
        return await item.getFilePathAsync();
    }
    // If it is a parent item, find its PDF attachment
    else if (item.isRegularItem() && !item.isAttachment()) {
        let attachments = await item.getAttachments();
        for (let attachmentID of attachments) {
            let attachment = await Zotero.Items.getAsync(attachmentID);
            if (attachment.attachmentContentType === 'application/pdf') {
                return await attachment.getFilePathAsync();
            }
			//break;
        }
    }
    return null;
}

async function openPDF(item) {
    let filePath = await getPDFAttachmentPath(item);
    if (!filePath) {
        Zotero.alert(window, "Open failed", "PDF attachment not found");
        return "PDF attachment not found";
    }
    let exePath = "C:\\Program Files\\Adobe\\Acrobat DC\\Acrobat\\Acrobat.exe";
    // Example: exe path string in windows, C:\\Program Files\\Mozilla Firefox\\firefox.exe
    Zotero.launchFileWithApplication(filePath, exePath);
}

// Open the currently selected items
for (const item of items) {
    await openPDF(item);
}
// Reduce prompt interference
// return "Opened successfully";

[mjthoraval]

Thank you very much!

[DWCY3574]

大佬想知道windows如何在父条目用quicklook加空格快捷键预览

[Geo123abc]

您好，这个动作只能“选中PDF条目-执行”才有效，能不能改进一下，使得“选中父条目-执行”也可以打开PDF？

[Geo123abc]

楼主好
我想使用QL-Win/QuickLook打开PDF，进行预览，然后探索出来下面两种方案

方案1：
使用你上述代码，指定一下QuickLook.exe的路径就可以，但是只能“选中PDF条目-执行”才有效，不能“选中父条目-执行”打开父条目下的PDF

方案2：
使用如下代码，无论父条目还是子条目都可以，感谢 @windingwind

if(item) return;

const window = require("window");
const ZoteroPane = require("ZoteroPane");

async function getPDFAttachmentPath(item) {
    // 如果是PDF，直接获取路径
    if (item.isAttachment() && item.attachmentContentType === 'application/pdf') {
        return await item.getFilePathAsync();
    }
    // 如果是父条目，查找其PDF附件
    else if (item.isRegularItem() && !item.isAttachment()) {
        let attachments = await item.getAttachments();
        for (let attachmentID of attachments) {
            let attachment = await Zotero.Items.getAsync(attachmentID);
            if (attachment.attachmentContentType === 'application/pdf') {
                return await attachment.getFilePathAsync();
            }
			//break;
        }
    }
    return null;
}

async function openPDF(item) {
    let path = await getPDFAttachmentPath(item);
    if (!path) {
        Zotero.alert(window, "打开失败", "未找到PDF附件");
        return "未找到PDF附件";
    }
  
    let exePath = Zotero.Prefs.get("extensions.actionsTags.mypdfapp2", true);
    if (!exePath) {
        exePath = window.prompt("输入打开PDF的exe程序路径");
        Zotero.Prefs.set("extensions.actionsTags.mypdfapp2", exePath, true);
    }
  
    // Example: exe path string in windows, C:\\QuickLook\\QuickLook.exe
    Zotero.launchFileWithApplication(path, exePath);
	// 减少提示干扰
    // return "打开成功";
}

// 你需要获取当前选中的条目
return await openPDF(items[0]);

[windingwind]

已修改，请尝试

[occasional15]

请教大佬，在使用时有2个疑问：1）本动作的执行应该是要在选中对应条目的情况下，但是，在侧边note中输入快捷键字符也会出发该动作，这是否应为bug呢？该如何解决呢？2）快捷键似乎是只限定了英文输入法的（所以每次都要shift一下才会触发快捷键），可以取消这一限制吗？

[Geo123abc]

我个人能力有限，不过我觉得这两个问题可能都需要插件做改动，动作脚本是解决不了的，不过我还是有一些经验分享一下
问题1：使用一些在note中不常用（或者根本不用）的快捷键作为打开PDF的快捷键
问题2：我这不存在这样的问题，你其它动作也存在这种问题吗？

[occasional15]

多谢解答！问题1我换个组合快捷键，问题2我再测试测试。

[gnyxng]

请问有遇到这种情况吗？尝试了把路径的双反斜线换成单斜线或单反斜线都不行。quicklook的运行程序是从GitHub下的7z压缩包解压的。

[dschaehi]

I modified the Quick Look code in #132 (comment) for MacOS:

if(item) return;

const window = require("window");
const ZoteroPane = require("ZoteroPane");

async function getPDFAttachmentPath(item) {
    if (item.isAttachment() && item.attachmentContentType === 'application/pdf') {
        return await item.getFilePathAsync();
    }
    else if (item.isRegularItem() && !item.isAttachment()) {
        let attachments = await item.getAttachments();
        for (let attachmentID of attachments) {
            let attachment = await Zotero.Items.getAsync(attachmentID);
            if (attachment.attachmentContentType === 'application/pdf') {
                return await attachment.getFilePathAsync();
            }
        }
    }
    return null;
}

async function openPDF(item) {
    let filePath = await getPDFAttachmentPath(item);
    if (!filePath) {
        Zotero.alert(window, "Failed to open.", "PDF attachment not found.");
        return "PDF attachment not found.";
    }

    let applicationPath = "/usr/bin/qlmanage"
	let args = ['-p', filePath]
	Zotero.Utilities.Internal.exec(applicationPath, args);
}
return await openPDF(items[0]);

[YaoLiMuMu]

@dschaehi For Linux and sushi quicklook, not only pdf, but also including doc, image, html, music, txt, epub. etc

if(item) return;

const window = require("window");
const ZoteroPane = require("ZoteroPane");

async function getAttachmentPath(item) {
    if (item.isAttachment() && !item.isNote()) {
        return await item.getFilePathAsync();
    }
    else if (item.isRegularItem() && !item.isAttachment()) {
        let attachments = await item.getAttachments();
        for (let attachmentID of attachments) {
            let attachment = await Zotero.Items.getAsync(attachmentID);
			return await attachment.getFilePathAsync();
        }
    }
    return null;
}

async function openFile(item) {
    let filePath = await getAttachmentPath(item);
    if (!filePath) {
        return false;
    }
    let applicationPath = "/usr/bin/sushi"
	let args = [filePath]
	Zotero.Utilities.Internal.exec(applicationPath, args);
}
return await openFile(items[0]);

[YaoLiMuMu]

Type Space bar and QuickLook, Thank you to the following two people for this discussion: @windingwind @iiwenwen

const ZoteroPane = require("ZoteroPane");
const Zotero_Tabs = require("Zotero_Tabs");
const document = require("document");

var lastItem = "";

async function getAttachmentPath(item) {
    if (item.isAttachment() && !item.isNote()) {
        return await item.getFilePathAsync();
    }
    else if (item.isRegularItem() && !item.isAttachment()) {
        let attachments = await item.getAttachments();
        for (let attachmentID of attachments) {
            let attachment = await Zotero.Items.getAsync(attachmentID);
			return await attachment.getFilePathAsync();
        }
    }
    return null;
}

async function openFile(item) {
    let filePath = await getAttachmentPath(item);
    if (!filePath) {
        return false;
    }
    // macbook path : -p /usr/bin/qlmanage
    // linux path : /usr/bin/sushi
    let applicationPath = "/usr/bin/sushi"
	let args = [filePath]
	Zotero.Utilities.Internal.exec(applicationPath, args);
}

async function oneKey(event) {
	var key = String.fromCharCode(event.which);
	let newItem = ZoteroPane.getSelectedItems()[0];
        if (Zotero_Tabs.selectedID === "zotero-pane") {
            if ((key == ' ' && !(event.ctrlKey || event.altKey || event.metaKey)) || (key == 'y' && event.metaKey && !(event.ctrlKey || event.altKey))) {
                if(newItem) {
                    lastItem = newItem;
                    return await openFile(newItem);
                }
                else {
                    return await openFile(lastItem);
                }
            }
        }
}

document.getElementById('zotero-items-tree').addEventListener("keydown", oneKey, false);

[enozkan]

This is working great. Thank you.

But how do we specify in the code for quicklook to open the main pdf attachment, and not the attachment file in the top of the list (which is alphabetical)? Or in other words, choose the attachment that Zotero would open in its viewer if I were to hit enter, but instead open in quicklook with space.

[lxysl]

Hi, I have implemented the functionality to open the first PDF attached to the item by adding the code if (attachment.attachmentContentType === 'application/pdf') @enozkan

const ZoteroPane = require("ZoteroPane");
const Zotero_Tabs = require("Zotero_Tabs");
const document = require("document");

async function getAttachmentPath(item) {
    if (item.isAttachment() && !item.isNote()) {
        return await item.getFilePathAsync();
    }
    else if (item.isRegularItem() && !item.isAttachment()) {
        let attachments = await item.getAttachments();
        for (let attachmentID of attachments) {
            let attachment = await Zotero.Items.getAsync(attachmentID);
            if (attachment.attachmentContentType === 'application/pdf') {
                return await attachment.getFilePathAsync();
            }
        }
    }
    return null;
}

async function openFile(item) {
    let filePath = await getAttachmentPath(item);
    if (!filePath) {
        return false;
    }
    // macbook path : -p /usr/bin/qlmanage
    // linux path : /usr/bin/sushi
    let applicationPath = "/usr/bin/qlmanage"
	let args = ['-p', filePath]
	Zotero.Utilities.Internal.exec(applicationPath, args);
}

async function oneKey(event) {
	var key = String.fromCharCode(event.which);
	let item = ZoteroPane.getSelectedItems()[0];
	if (Zotero_Tabs.selectedID === "zotero-pane") {
		if ((key == ' ' && !(event.ctrlKey || event.altKey || event.metaKey)) || (key == 'y' && event.metaKey && !(event.ctrlKey || event.altKey))) {
			await openFile(item);
			ZoteroPane.collectionsView.selectItems([item.id]);
			return 
		}
	}
}

document.getElementById('zotero-items-tree').addEventListener("keydown", oneKey, false);

[enozkan]

Thank you.

[zoelir729]

Sorry to ask, I added the script, but an error occured, did not know how to slove, thanks:
This script is using ZoteroPane.getSelectedItems, which is NOT recommended for getting items in scripts and can lead to unexpected behavior. Please use the item or items variables passed to the script instead.

[jakowag]

@zoelir729 and whom else it might concern: I fixed it with the following adjustments:

(function () {

const ZoteroPane = require("ZoteroPane");
const Zotero_Tabs = require("Zotero_Tabs");
const document = require("document");

async function getAttachmentPath(item) {
    if (item.isAttachment() && !item.isNote()) {
        return await item.getFilePathAsync();
    }
    else if (item.isRegularItem() && !item.isAttachment()) {
        let attachments = await item.getAttachments();
        for (let attachmentID of attachments) {
            let attachment = await Zotero.Items.getAsync(attachmentID);
            if (attachment.attachmentContentType === 'application/pdf') {
                return await attachment.getFilePathAsync();
            }
        }
    }
    return null;
}

async function openFile(item) {
    let filePath = await getAttachmentPath(item);
    if (!filePath) {
        return false;
    }
    // macbook path : -p /usr/bin/qlmanage
    // linux path : /usr/bin/sushi
    let applicationPath = "/usr/bin/qlmanage" // IM ON A MAC, ADJUST THIS IF YOU HAVE LINUX
    let args = ['-p', filePath] // THIS TOO
    Zotero.Utilities.Internal.exec(applicationPath, args);
}

async function oneKey(event) {
    if (event.code != "Space") return;
    let item = ZoteroPane.getSelectedItems()[0];
    if (typeof item === 'undefined') {
        Zotero.debug("No item selected for quicklook.");
        return false;
    }
    var key = String.fromCharCode(event.which);
    if (Zotero_Tabs.selectedID === "zotero-pane") {
		await openFile(item);
		ZoteroPane.collectionsView.selectItems([item.id]); // reselect the current item to close it directly 
		return;
    }
}

document.getElementById('zotero-items-tree').addEventListener("keydown", oneKey, false);
})()

I don't know why exactly but it seems like the requirements are not properly initialized properly anymore without the self execution of the script. Switching to the event code of the KeyboardEvent when pressing the spacebar is probably a bit cleaner too.

Furthermore, I changed the event in the action config to Program Startup

[zxq309]

@YaoLiMuMu Can this code be run on windows, I can't get it to work when I try to run it.

[lxysl]

It certainly cannot. See the source code: // macbook path : -p /usr/bin/qlmanage, it uses the quicklook application on mac.

[YaoLiMuMu]

@YaoLiMuMu Can this code be run on windows, I can't get it to work when I try to run it.

@zxq309 For windows, please install quicklook(QL) and Bridge

const ZoteroPane = require("ZoteroPane");
const Zotero_Tabs = require("Zotero_Tabs");
const document = require("document");

async function getAttachmentPath(item) {
    if (item.isAttachment() && !item.isNote()) {
        return await item.getFilePathAsync();
    }
    else if (item.isRegularItem() && !item.isAttachment()) {
        let attachments = await item.getAttachments();
        for (let attachmentID of attachments) {
            let attachment = await Zotero.Items.getAsync(attachmentID);
			return await attachment.getFilePathAsync();
        }
    }
    return null;
}

async function openFile(item) {
    let filePath = await getAttachmentPath(item);
    if (!filePath) {
        return false;
    }
    // macbook path : -p /usr/bin/qlmanage
    // linux path : /usr/bin/sushi
    // For window path: D:\\Bridge\\Bridge.exe
    let applicationPath = "D:\\Bridge\\Bridge.exe";
	let args = [filePath]
	Zotero.Utilities.Internal.exec(applicationPath, args);
}

async function oneKey(event) {
	var key = String.fromCharCode(event.which);
	let item = ZoteroPane.getSelectedItems()[0];
	if (Zotero_Tabs.selectedID === "zotero-pane") {
		if ((key == ' ' && !(event.ctrlKey || event.altKey || event.metaKey)) || (key == 'y' && event.metaKey && !(event.ctrlKey || event.altKey))) {
			await openFile(item);
			ZoteroPane.collectionsView.selectItems([item.id]);
			return 
		}
	}
}

document.getElementById('zotero-items-tree').addEventListener("keydown", oneKey, false);

Remember to restart your Zotero

[zxq309]

@YaoLiMuMu I opened it with the code you gave me, and this error occurred. What's going on?

[benzBrake]

我写了一个可以弹出文件选择框的版本，这样就不用手动处理转义的问题了

if (!items?.length) return;

const window = require("window");

async function getPDFAttachmentPath (item) {
    // If it is PDF, get the path directly
    if (item.isAttachment() && item.attachmentContentType === 'application/pdf') {
        return await item.getFilePathAsync();
    }
    // If it is a parent item, find its PDF attachment
    else if (item.isRegularItem() && !item.isAttachment()) {
        let attachments = await item.getAttachments();
        for (let attachmentID of attachments) {
            let attachment = await Zotero.Items.getAsync(attachmentID);
            if (attachment.attachmentContentType === 'application/pdf') {
                return await attachment.getFilePathAsync();
            }
            //break;
        }
    }
    return null;
}

async function getPDFReaderExecutablePath () {
    try {
        const reader = Services.prefs.getComplexValue("extensions.actionsTags.pdfReader", Ci.nsIFile);
        if (reader.exists()) return reader.path;
    } catch (e) { }
    return null;
}

async function selectPDFReader () {
    const fp = Cc['@mozilla.org/filepicker;1'].createInstance(Ci.nsIFilePicker);
    fp.init(
        !("inIsolatedMozBrowser" in window.browsingContext.originAttributes)
            ? window.browsingContext
            : window,
        "Select PDF Reader",
        fp.modeOpen
    );
    fp.appendFilters(Ci.nsIFilePicker.filterApps);
    return await new Promise(resolve => {
        fp.open(res => resolve(res === Ci.nsIFilePicker.returnOK ? fp.file : null));
    });
}

async function openPDF (item) {
    let filePath = await getPDFAttachmentPath(item);
    if (!filePath) {
        Zotero.alert(window, "Open failed", "PDF attachment not found");
        return "PDF attachment not found";
    }
    let execPath = await getPDFReaderExecutablePath();
    if (!execPath) {
        throw new Error("PDF reader not found");
    }
    Zotero.launchFileWithApplication(filePath, execPath);
}

let execPath = await getPDFReaderExecutablePath();
if (!execPath) {
    let execPath = await selectPDFReader();
    Services.prefs.setComplexValue("extensions.actionsTags.pdfReader", Ci.nsIFile, execPath);
    if (!execPath) {
        throw new Error("PDF reader not found");
    }
}

for (const item of items) {
    try {
        await openPDF(item);
    } catch (e) {
        return e.message;
    }
}

[chen19992000]

请问下我设置了zotero默认用其他软件（ADOBE DC）打开PDF，有时候想用zotero自带PDF阅读器软件内部打开PDF，怎么设置呢？输入了你给的脚本，然后选择了zotero.exe程序，但是打不开PDF

[occasional15]

默认内置阅读器，外置的用快捷键，可以参考我的教程和设置：
Zotero 7使用任意外部程序打开PDF（并自定义快捷键）
https://mp.weixin.qq.com/s/8nkI1NO-ENY8oTvyLdvbJA

[joker-cai]

重新编写，使得quicklook能够打开任意文件，并非只有PDF文件。原理上Quicklook支持的可打开的文件类型都能用上。

目前还有个小问题：
启用Quicklook打开目标文件后，我预览条目里的文件时需要按键盘的“↑”和“↓”去跳转上或下一个条目，但是现在摁键盘时，会跳转到菜单栏。也就是希望要执行完这段代码以后还要确保当前选中的还是当前条目，再摁键盘就可以跳转到其他条目上去。

这个目前不好实现，可能是因为当 QuickLook 打开后，Zotero 的窗口仍然拥有键盘焦点，而菜单栏的快捷键（比如↑，↓可能被菜单的导航捕获）优先于用户期望的条目跳转功能。

不过也不影响使用，因为Quciklook始终在屏幕置顶，所以只需要用鼠标去单击你想要点开的条目，再去摁预设的快捷键就能连续打开了

if(item) return;

const window = require("window");
const ZoteroPane = require("ZoteroPane");

/**
 * 获取任意类型附件的本地路径
 * @param {Zotero.Item} item - Zotero条目
 * @returns {Promise<string|null>} 附件本地路径，无有效附件时返回null
 */
async function getAttachmentPath(item) {
    // 如果是附件条目，直接获取路径（不限制类型）
    if (item.isAttachment()) {
        // 检查是否为本地可访问的附件（排除在线附件）
        const linkMode = item.attachmentLinkMode;
        // 0: 链接的文件, 2: 嵌入的文件, 3: 链接的URL(可能无法本地打开)
        if (linkMode === 0 || linkMode === 2) {
            const path = await item.getFilePathAsync();
            return path || null;
        }
        return null;
    }
    // 如果是父条目，查找其第一个有效附件（任意类型）
    else if (item.isRegularItem() && !item.isAttachment()) {
        let attachments = await item.getAttachments();
        for (let attachmentID of attachments) {
            let attachment = await Zotero.Items.getAsync(attachmentID);
            // 检查附件是否可本地访问
            const linkMode = attachment.attachmentLinkMode;
            if (linkMode === 0 || linkMode === 2) {
                const path = await attachment.getFilePathAsync();
                if (path) return path;
            }
        }
    }
    return null;
}

/**
 * 使用QuickLook打开选中条目的附件（任意类型）
 * @param {Zotero.Item} item - Zotero条目
 * @returns {Promise<string>} 操作结果提示
 */
async function openAttachment(item) {
    let path = await getAttachmentPath(item);
    if (!path) {
        Zotero.alert(window, "打开失败", "未找到可访问的本地附件");
        return "未找到可访问的本地附件";
    }
  
    // 获取QuickLook程序路径（优先使用已保存的设置）
    let exePath = Zotero.Prefs.get("extensions.actionsTags.quickLookPath", true);
    if (!exePath) {
        // 提示用户输入QuickLook路径（默认给出常见安装路径）
        exePath = window.prompt("QuickLook.exe的路径，按自己实际的安装位置去替换");
        if (exePath) {
            Zotero.Prefs.set("extensions.actionsTags.quickLookPath", exePath, true);
        } else {
            Zotero.alert(window, "路径未设置", "请先设置QuickLook程序路径");
            return "路径未设置";
        }
    }
    
    // 启动QuickLook打开目标文件
    Zotero.launchFileWithApplication(path, exePath);
    // 减少提示干扰
    // return "正在用QuickLook打开文件";
}

// 打开当前选中的第一个条目
return await openAttachment(items[0]);